Working with configuration options

Streamlit 提供了四种不同的方式来设置配置选项。此列表按优先级逆序排列,即当多次提供相同的配置选项时,命令行标志优先于环境变量。

push_pin

注意

如果你在应用程序运行时更改.streamlit/config.toml中的主题设置,这些更改将立即反映出来。如果你在应用程序运行时更改.streamlit/config.toml中的非主题设置,则需要重新启动服务器以使更改在应用程序中生效。

  1. 全局配置文件中,位于~/.streamlit/config.toml(适用于macOS/Linux)或%userprofile%/.streamlit/config.toml(适用于Windows):

    [server] port = 80
  2. 每个项目的配置文件中,位于$CWD/.streamlit/config.toml,其中 $CWD是您运行Streamlit的文件夹。

  3. 通过 STREAMLIT_* 环境变量,例如:

    export STREAMLIT_SERVER_PORT=80 export STREAMLIT_SERVER_COOKIE_SECRET=dontforgottochangeme
  4. 作为命令行上的标志,在运行streamlit run时:

    streamlit run your_script.py --server.port 80

所有可用的配置选项都在config.toml中有文档记录。这些选项可以在TOML文件中声明,作为环境变量,或作为命令行选项。

当使用环境变量覆盖config.toml时,将变量(包括其部分标题)转换为大写蛇形命名法,并添加STREAMLIT_前缀。例如,STREAMLIT_CLIENT_SHOW_ERROR_DETAILS相当于TOML中的以下内容:

[client] showErrorDetails = true

当使用命令行选项覆盖config.toml和环境变量时,使用与TOML文件中相同的大小写,并包括以句点分隔的前缀作为部分标题。例如,命令行选项--server.enableStaticServing true等同于以下内容:

[server] enableStaticServing = true

正如安装过程中提到的,Streamlit 会收集使用统计信息。您可以通过阅读我们的隐私声明了解更多信息,但简而言之,尽管我们收集遥测数据,但我们无法查看也不会存储 Streamlit 应用程序中包含的信息。

如果您想选择退出使用统计,请在配置文件中添加以下内容:

[browser] gatherUsageStats = false

你可以使用配置系统的[theme]部分来更改应用程序的基本颜色。 要了解更多信息,请参阅Theming.

命令行选项中所述,您可以使用以下命令查看所有可用的配置选项:

streamlit config show
forum

还有问题吗?

我们的 论坛 充满了有用的信息和Streamlit专家。