documentation/config.md at 4d3fc9f62b42949cc5e347c9c84cfd53d61dae6f

5.4 KiB

Raw Blame History

title

description

设置你的环境

为你安装的Mastodon设置环境变量。

docs

weight	parent
30	admin

{{< hint style="warning" >}} 本页面仍在建设中。 {{< /hint >}}

Mastodon使用环境变量作为其的配置。

为了方便起见，Mastodon从Mastodon目录中的 .env.production 文件读取环境变量，但是始终可以用特定方式覆盖它们。例如：在 systemd service 文件中可以使用 EnvironmentFile 从特定文件中读取环境变量或使用 Environment 定义环境变量，因此你可以为不同服务指定不同的环境变量。也可以在从命令行调用运行Mastodon时指定环境变量。

基本参数

站点互联

LOCAL_DOMAIN
WEB_DOMAIN
ALTERNATE_DOMAINS

`AUTHORIZED_FETCH`

当设置为 true 时，Mastodon将停止内联签名活动，并要求远程服务器在拉取公开（public）和不公开（unlisted）的嘟文时进行身份验证。

这可以阻止被屏蔽的域名拉取你的公开嘟文，但代价是可能增加计算量，并与不支持附带签名的拉取请求的软件不兼容（如低于3.0版本的Mastodon）。

请注意：这个模式并不能保证你的公开嘟文（public、unlisted）不被恶意操作者获取，这仅仅是增加了一点难度。

`WHITELIST_MODE`

当设置为 true 时，Mastodon将仅与白名单内的服务器互联，同时关闭公开页面和一些客户端API。白名单模式会启用 authorized fetch 模式。

当一个现存实例站点切换至白名单模式，以下命令可以被用来移除非白名单站点的数据：

tootctl domain purge --whitelist-mode

请注意：虽然Mastodon 3.0 版本便引入了白名单模式 WHITELIST_MODE，但在Mastodon 3.0和3.0.1版中并没有正确实现。

密钥

SECRET_KEY_BASE
OTP_SECRET
VAPID_PRIVATE_KEY
VAPID_PUBLIC_KEY

部署

RAILS_ENV
RAILS_SERVE_STATIC_FILES
RAILS_LOG_LEVEL
TRUSTED_PROXY_IP
SOCKET
PORT
NODE_ENV
BIND

缩放选项

WEB_CONCURRENCY
MAX_THREADS
PREPARED_STATEMENTS
STREAMING_API_BASE_URL
STREAMING_CLUSTER_NUM

数据库连接

PostgreSQL

DB_HOST
DB_USER
DB_NAME
DB_PASS
DB_PORT
DB_SSLMODE
DATABASE_URL

Redis

REDIS_HOST
REDIS_PORT
REDIS_URL
REDIS_NAMESPACE
CACHE_REDIS_HOST
CACHE_REDIS_PORT
CACHE_REDIS_URL
CACHE_REDIS_NAMESPACE

Elasticsearch

ES_ENABLED
ES_HOST
ES_PORT
ES_PREFIX

StatsD

STATSD_ADDR
STATSD_NAMESPACE

限制

SINGLE_USER_MODE
EMAIL_DOMAIN_WHITELIST
DEFAULT_LOCALE
MAX_SESSION_ACTIVATIONS
USER_ACTIVE_DAYS

电子邮件

SMTP_SERVER
SMTP_PORT
SMTP_LOGIN
SMTP_PASSWORD
SMTP_FROM_ADDRESS
SMTP_DOMAIN
SMTP_DELIVERY_METHOD
SMTP_AUTH_METHOD
SMTP_CA_FILE
SMTP_OPENSSL_VERIFY_MODE
SMTP_ENABLE_STARTTLS_AUTO
SMTP_TLS

文件存储

CDN_HOST
S3_ALIAS_HOST

本地文件存储

PAPERCLIP_ROOT_PATH
PAPERCLIP_ROOT_URL

Amazon S3 及其兼容存储

S3_ENABLED
S3_BUCKET
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
S3_REGION
S3_PROTOCOL
S3_HOSTNAME
S3_ENDPOINT
S3_SIGNATURE_VERSION

Swift

SWIFT_ENABLED
SWIFT_USERNAME
SWIFT_TENANT
SWIFT_PASSWORD
SWIFT_PROJECT_ID
SWIFT_AUTH_URL
SWIFT_CONTAINER
SWIFT_OBJECT_URL
SWIFT_REGION
SWIFT_DOMAIN_NAME
SWIFT_CACHE_TTL

外部认证

OAUTH_REDIRECT_AT_SIGN_IN

LDAP

LDAP_ENABLED
LDAP_HOST
LDAP_PORT
LDAP_METHOD
LDAP_BASE
LDAP_BIND_DN
LDAP_PASSWORD
LDAP_UID
LDAP_SEARCH_FILTER

PAM

PAM_ENABLED
PAM_EMAIL_DOMAIN
PAM_DEFAULT_SERVICE
PAM_CONTROLLED_SERVICE

CAS

CAS_ENABLED
CAS_URL
CAS_HOST
CAS_PORT
CAS_SSL
CAS_VALIDATE_URL
CAS_CALLBACK_URL
CAS_LOGOUT_URL
CAS_LOGIN_URL
CAS_UID_FIELD
CAS_CA_PATH
CAS_DISABLE_SSL_VERIFICATION
CAS_UID_KEY
CAS_NAME_KEY
CAS_EMAIL_KEY
CAS_NICKNAME_KEY
CAS_FIRST_NAME_KEY
CAS_LAST_NAME_KEY
CAS_LOCATION_KEY
CAS_IMAGE_KEY
CAS_PHONE_KEY

SAML

SAML_ENABLED
SAML_ACS_URL
SAML_ISSUER
SAML_IDP_SSO_TARGET_URL
SAML_IDP_CERT
SAML_IDP_CERT_FINGERPRINT
SAML_NAME_IDENTIFIER_FORMAT
SAML_CERT
SAML_PRIVATE_KEY
SAML_SECURITY_WANT_ASSERTION_SIGNED
SAML_SECURITY_WANT_ASSERTION_ENCRYPTED
SAML_SECURITY_ASSUME_EMAIL_IS_VERIFIED
SAML_ATTRIBUTES_STATEMENTS_UID
SAML_ATTRIBUTES_STATEMENTS_EMAIL
SAML_ATTRIBUTES_STATEMENTS_FULL_NAME
SAML_ATTRIBUTES_STATEMENTS_FIRST_NAME
SAML_ATTRIBUTES_STATEMENTS_LAST_NAME
SAML_UID_ATTRIBUTE
SAML_ATTRIBUTES_STATEMENTS_VERIFIED
SAML_ATTRIBUTES_STATEMENTS_VERIFIED_EMAIL

隐藏服务

http_proxy
ALLOW_ACCESS_TO_HIDDEN_SERVICE

其它

SKIP_POST_DEPLOYMENT_MIGRATIONS

{{< translation-status-zh-cn raw_title="Configuring your environment" raw_link="/admin/config/" last_tranlation_time="2020-05-04" raw_commit="ad1ef20f171c9f61439f32168987b0b4f9abd74b">}}

5.4 KiB Raw Blame History Unescape Escape