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应用：
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应用。
