streamlit run的启动参数讲解

当你运行 streamlit run 命令时，后面可以带一些参数，用来指定如何运行 Streamlit 应用。下面是 streamlit run 命令的常用参数及其含义：

基本命令：

streamlit run your_script.py

这个命令会启动 your_script.py 这个 Streamlit 应用。基本的用法就是指定你要运行的 Python 脚本。

常用参数：

1. --server.port

   • 作用：指定 Streamlit 应用运行的端口。
   • 示例：

     streamlit run your_script.py --server.port 8502
     

   • 解释：如果你想让应用在端口 8502 上运行，而不是默认的 8501，你可以使用这个参数。

2. --server.address

   • 作用：指定 Streamlit 应用的绑定地址。
   • 示例：

     streamlit run your_script.py --server.address 0.0.0.0
     

   • 解释：这个参数通常用于允许其他机器访问你运行的 Streamlit 应用。如果设置为 0.0.0.0，表示应用将绑定到所有可用的网络接口上，使其可以从外部访问。

3. --server.headless

   • 作用：指示 Streamlit 是否以无头模式（headless mode）运行。
   • 示例：

     streamlit run your_script.py --server.headless true
     

   • 解释：在某些环境（如远程服务器或 Docker）中，可能没有图形界面。这时可以使用 --server.headless true 启动无头模式，这样应用会在后台运行，不依赖于显示输出。

4. --server.runOnSave

   • 作用：是否在每次保存文件时自动重新启动应用。
   • 示例：

     streamlit run your_script.py --server.runOnSave true
     

   • 解释：默认情况下，Streamlit 会在代码更改时自动重新加载应用。如果你希望禁用这个功能，可以将其设置为 false。

5. --browser.gatherUsageStats

   • 作用：设置是否收集 Streamlit 使用数据。
   • 示例：

     streamlit run your_script.py --browser.gatherUsageStats false
     

   • 解释：设置为 false 可以关闭 Streamlit 收集使用数据的功能（例如，页面访问次数等统计信息）。

6. --theme

   • 作用：设置应用的主题（例如，颜色、字体等）。
   • 示例：

     streamlit run your_script.py --theme.base "dark"
     

   • 解释：通过指定 --theme.base 参数，你可以设置应用的主题。可以选择 dark 或 light，或自定义其他主题设置。

7. --useSeamless

   • 作用：启用无缝应用更新功能。
   • 示例：

     streamlit run your_script.py --useSeamless true
     

   • 解释：启用后，Streamlit 会在你编辑和保存脚本时尽量避免应用页面的闪烁和刷新。

8. --global.developmentMode

   • 作用：在开发模式下启用调试信息。
   • 示例：

     streamlit run your_script.py --global.developmentMode true
     

   • 解释：这个选项会在开发模式下输出更多的调试信息，有助于开发者调试应用。

9. --log_level

   • 作用：设置日志级别，控制显示日志的详细程度。
   • 示例：

     streamlit run your_script.py --log_level debug
     

   • 解释：你可以设置日志级别为 debug、info、warning 或 error，来控制输出的日志详细程度。

结合参数的例子：

如果你希望 Streamlit 应用在远程服务器上运行，并绑定到 0.0.0.0，端口为 8502，并且在开发过程中不需要每次修改代码后手动刷新，可以使用如下命令：

streamlit run your_script.py --server.address 0.0.0.0 --server.port 8502 --server.runOnSave true --server.headless true

这将启动应用，允许其他设备通过服务器的 IP 地址和端口 8502 访问，同时应用会自动重新加载并且不依赖图形界面。

这些参数可以组合使用，具体参数设置取决于你的需求，特别是在开发、生产或远程服务器上运行时。