本教程旨在解决在Windows系统上运行Streamlit应用时遇到的WinError 10013端口权限错误。该错误通常表示Streamlit默认端口被占用或受权限限制。核心解决方案是通过创建或修改.streamlit/config.toml配置文件，将Streamlit服务器的运行端口更改为其他可用的非特权端口，从而避免端口冲突和权限问题，确保应用顺利启动。
1. 理解 WinError 10013 错误
当您在windows命令行（cmd）中运行streamlit应用时，如果遇到permissionerror: [winerror 10013] an attempt was made to access a socket in a way forbidden by its access permissions，这通常意味着streamlit尝试使用的网络端口（默认为8501）存在问题。具体来说，这个端口可能：
已被其他应用程序占用： 您的系统上可能有其他程序正在使用Streamlit尝试绑定的端口。权限受限： 某些端口，尤其是低于1024的特权端口（如80或443），在Windows上可能需要管理员权限才能绑定，或者被系统安全策略、防火墙等阻止。
2. Streamlit 应用示例
假设您有一个名为main.py的Streamlit应用，内容如下：
import streamlit as stimport pandas as pdst.write("""# 我的第一个 Streamlit 应用你好 *世界!* """)# 假设 data/customer_booking.csv 存在且可读try: df = pd.read_csv("data/customer_booking.csv", encoding="ISO-8859-1") st.line_chart(df["purchase_lead"])except FileNotFoundError: st.error("数据文件 'data/customer_booking.csv' 未找到。请确保文件路径正确。")except Exception as e: st.error(f"加载数据时发生错误: {e}")
当您在命令行中尝试运行 streamlit run main.py 时，如果遇到上述 WinError 10013，就需要采取端口更改的解决方案。
3. 解决方案：更改 Streamlit 服务器端口
解决 WinError 10013 的最直接方法是更改Streamlit服务器的默认运行端口。这可以通过在 .streamlit/config.toml 文件中进行配置来实现。
3.1 创建或修改 config.toml 文件
定位配置目录： Streamlit 会在以下位置查找配置文件：
当前项目根目录下的 .streamlit/ 文件夹。用户主目录下的 .streamlit/ 文件夹（例如：C:UsersYourUser.streamlit）。建议在您的Streamlit项目根目录下创建 .streamlit/ 文件夹，这样配置只对当前项目生效。
创建 config.toml 文件： 在 .streamlit/ 文件夹内创建一个名为 config.toml 的文件。
添加端口配置： 打开 config.toml 文件，并添加以下内容：
[server]port = 8080
这里，我们将端口设置为 8080。您可以选择任何未被占用且权限不受限的端口，例如 5000、8000、8501（如果默认端口之前因其他原因被占用，但现在可用），或者其他高于 1024 的端口。
3.2 运行 Streamlit 应用
保存 config.toml 文件后，再次在命令行中运行您的Streamlit应用：
streamlit run main.py
Streamlit 将会尝试在您指定的端口（例如 8080）上启动服务器，而不是默认的 8501 端口。如果 8080 端口可用且没有权限问题，您的应用将成功启动并在浏览器中打开。
4. 注意事项与高级配置
选择合适的端口：
避免特权端口： 尽量避免使用 1 到 1023 之间的端口，这些是系统保留的特权端口，通常需要管理员权限才能使用。选择常用非特权端口： 8080, 5000, 8000, 3000 都是常见的Web应用端口，冲突几率相对较低。检查端口占用： 在Windows上，您可以使用 netstat -ano | findstr : 命令来检查特定端口是否被占用，并找出占用该端口的进程ID。
防火墙设置： 如果您的系统防火墙比较严格，即使端口未被占用，也可能阻止Streamlit监听该端口。您可能需要为Streamlit或选定的端口添加入站规则。
.streamlit 文件夹的位置：
项目级配置： 将 .streamlit/config.toml 放在您的Streamlit项目根目录下，可以确保该配置仅应用于当前项目。全局配置： 如果您希望所有Streamlit应用都使用相同的非默认端口，可以将 .streamlit/config.toml 放在用户主目录下。项目级配置会覆盖全局配置。
其他 server 配置选项： config.toml 中的 [server] 部分还有其他有用的配置，例如：
headless = true：在没有浏览器的情况下运行Streamlit。enableCORS = false：禁用CORS，这在某些网络环境中可能有用。baseUrlPath = “/streamlit”：为Streamlit应用设置一个基础URL路径，适用于反向代理场景。
5. 总结
WinError 10013 错误在Streamlit中通常是由于端口冲突或权限不足引起的。通过简单地创建或修改 .streamlit/config.toml 文件，并指定一个可用的非特权端口，可以有效地解决这个问题。理解端口管理和Streamlit的配置机制，能够帮助开发者更顺畅地部署和运行Streamlit应用。
以上就是解决 Streamlit WinError 10013 端口权限问题的教程的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1376654.html
微信扫一扫 
支付宝扫一扫 
