解决 Streamlit WinError 10013 端口权限问题的教程-Python教程-PHP中文网

解决 Streamlit WinError 10013 端口权限问题的教程

聖光之護

发布： 2025-10-09 11:17:32

原创

637人浏览过

解决 Streamlit WinError 10013 端口权限问题的教程

本教程旨在解决在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 st
import pandas as pd

st.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:\Users\YourUser\.streamlit\）。建议在您的Streamlit项目根目录下创建 .streamlit/ 文件夹，这样配置只对当前项目生效。
创建 config.toml 文件： 在 .streamlit/ 文件夹内创建一个名为 config.toml 的文件。
添加端口配置： 打开 config.toml 文件，并添加以下内容：
```
[server]
port = 8080
```
登录后复制
这里，我们将端口设置为 8080。您可以选择任何未被占用且权限不受限的端口，例如 5000、8000、8501（如果默认端口之前因其他原因被占用，但现在可用），或者其他高于 1024 的端口。

3.2 运行 Streamlit 应用

保存 config.toml 文件后，再次在命令行中运行您的Streamlit应用：

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

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 端口权限问题的教程的详细内容，更多请关注php中文网其它相关文章！