Working with configuration options
Streamlit 提供了四种不同的方式来设置配置选项。此列表按优先级逆序排列,即当多次提供相同的配置选项时,命令行标志优先于环境变量。
注意
如果你在应用程序运行时更改.streamlit/config.toml
中的主题设置,这些更改将立即反映出来。如果你在应用程序运行时更改.streamlit/config.toml
中的非主题设置,则需要重新启动服务器以使更改在应用程序中生效。
-
在全局配置文件中,位于
~/.streamlit/config.toml
(适用于macOS/Linux)或%userprofile%/.streamlit/config.toml
(适用于Windows):[server] port = 80
-
在每个项目的配置文件中,位于
$CWD/.streamlit/config.toml
,其中$CWD
是您运行Streamlit的文件夹。 -
通过
STREAMLIT_*
环境变量,例如:export STREAMLIT_SERVER_PORT=80 export STREAMLIT_SERVER_COOKIE_SECRET=dontforgottochangeme
-
作为命令行上的标志,在运行
streamlit run
时:streamlit run your_script.py --server.port 80
Available options
所有可用的配置选项都在config.toml
中有文档记录。这些选项可以在TOML文件中声明,作为环境变量,或作为命令行选项。
当使用环境变量覆盖config.toml
时,将变量(包括其部分标题)转换为大写蛇形命名法,并添加STREAMLIT_
前缀。例如,STREAMLIT_CLIENT_SHOW_ERROR_DETAILS
相当于TOML中的以下内容:
[client]
showErrorDetails = true
当使用命令行选项覆盖config.toml
和环境变量时,使用与TOML文件中相同的大小写,并包括以句点分隔的前缀作为部分标题。例如,命令行选项--server.enableStaticServing true
等同于以下内容:
[server]
enableStaticServing = true
Telemetry
正如安装过程中提到的,Streamlit 会收集使用统计信息。您可以通过阅读我们的隐私声明了解更多信息,但简而言之,尽管我们收集遥测数据,但我们无法查看也不会存储 Streamlit 应用程序中包含的信息。
如果您想选择退出使用统计,请在配置文件中添加以下内容:
[browser]
gatherUsageStats = false
Theming
你可以使用配置系统的[theme]
部分来更改应用程序的基本颜色。
要了解更多信息,请参阅Theming.
View all configuration options
如命令行选项中所述,您可以使用以下命令查看所有可用的配置选项:
streamlit config show
还有问题吗?
我们的 论坛 充满了有用的信息和Streamlit专家。