NGINX
NGINX 是最可靠的 Web 服务器之一。由于 docmd 的输出完全是静态的，NGINX 可以以接近零延迟的方式提供这些内容。
生成 nginx.conf
npx @docmd/core deploy --nginx
这会生成一份针对您的项目个性化定制的 nginx.conf：
server_name会被设置为从您的url配置中提取的主机名。如果未设置，则回退为localhost。- SPA 回退 (
try_files ... /index.html) 仅在您的配置中layout.spa为true时才会包含。 - 安全头、GZIP 压缩以及不可变的资源缓存默认开启。
生成内容示例
nginx.conf
server {
listen 80;
server_name docs.example.com;
root /usr/share/nginx/html;
index index.html;
# 安全
server_tokens off;
add_header X-Content-Type-Options "nosniff" always;
add_header X-Frame-Options "SAMEORIGIN" always;
# GZIP 压缩
gzip on;
gzip_vary on;
gzip_min_length 256;
gzip_types text/plain text/css application/json application/javascript
text/xml application/xml application/xml+rss text/javascript
image/svg+xml;
# SPA 路由回退（仅在 layout.spa 为 true 时）
location / {
try_files $uri $uri/ /index.html;
}
# 自定义 404
error_page 404 /404.html;
# 缓存静态资源（6 个月，immutable）
location ~* \.(?:ico|css|js|gif|jpe?g|png|webp|avif|woff2?|eot|ttf|otf|svg)$ {
expires 6M;
access_log off;
add_header Cache-Control "public, immutable";
}
}
部署步骤
- 构建您的站点：
npx @docmd/core build - 将输出目录中的内容上传到服务器 Web 根目录（例如
/var/www/html/或/usr/share/nginx/html/）。 - 将生成的
nginx.conf放入服务器的配置目录（例如/etc/nginx/conf.d/default.conf）。 - 重启 NGINX：
sudo systemctl restart nginx
重新生成
修改了站点 URL，或关闭了 SPA 模式？只需再次运行 npx @docmd/core deploy --nginx。配置文件会自动重新生成，以匹配您当前的 docmd.config.json。