# 服务配置

./config/server.js用于定义 Strapi 应用程序的服务器配置。

✋ CAUTION

server.js 文件进行更改需要重建管理面板。保存修改后的文件后,在终端中运行 yarn buildnpm run build 来实现更改。

# 可用选项

./config/server.js 文件可以包含以下参数:

参数 描述 类型 默认值
host

❗️ Mandatory
主机名 string localhost
port

❗️ Mandatory
服务器应在其上运行的端口 integer 1337
app.keys

❗️ Mandatory
声明会话密钥 (基于 Koa session (opens new window)), 它由 session 中间件用于用户和权限插件以及文档 string undefined
socket 侦听套接字。当提供此选项时,主机和端口是装饰性的,同样在使用此选项时使用 url 来生成正确的 URL。此选项对于在不公开端口和在同一台计算机上使用代理服务器的情况下运行服务器非常有用 (例如, Heroku nginx buildpack (opens new window)) string | integer /tmp/nginx.socket
emitErrors 启用在发生错误时向 koa 发出错误,以便附加自定义逻辑或使用错误报告服务。 boolean false
url 服务器的公共网址。许多不同功能(例如:重置密码,第三个登录提供程序等)是必需的。还启用了代理支持,例如 Apache 或 Nginx,例如:https://mywebsite.com/api。url 可以是相对的,如果是这样,则与 http://${host}:${port} 一起使用作为基本 url。但是,建议使用绝对 URL。 string ''
proxy 设置 koa 变量 app.proxy。当 true 时,代理标头字段将受信任。 boolean false
cron Cron 配置 (node-schedule (opens new window) 提供) object
cron.enabled 启用或禁用 CRON jobs 在特定位置安排作业 dates. boolean false
cron.tasks 声明 CRON jobs 以特定方式运行 dates. object
dirs Strapi 使用的不同目录的路径配置。 object
dirs.public 自定义公用文件夹的路径。 string ./public

# 配置

./config/server.js 文件至少应包含带有 hostport 参数的最小配置。对于完整配置,可以包含其他参数。

✏️ NOTE

环境配置 (即使用 env() 帮助程序) 不需要包含所有值,只要它们存在于默认的 ./config/server.js 中。