美国服务器部署Linux网站,Nginx、证书与进程守护怎么配置
部署完成后,网站应达到这样的状态:公网只开放网站所需的 HTTP、HTTPS 入口和受限的管理入口;Nginx 接收请求并转发给本机应用;证书能够自动续期;应用退出后由 systemd 拉起;日志可定位故障,发布失败时能够恢复上一版本。应用端口不直接暴露到公网,也不依赖 SSH 会话维持运行。

美国服务器部署 Linux 网站,配置方法主要由发行版和应用运行方式决定,机房所在地区不会改变 Nginx、证书或进程守护的基本流程。下面以 Ubuntu 24.04 LTS、Nginx、Python WSGI 应用、Gunicorn 和 systemd 为例给出操作步骤。其他语言可以保留 Nginx 与证书配置,但必须替换应用启动命令和健康检查方式;跨地区访问的网络时延,则需要另行从目标用户所在地验证。
一、准备条件:先确认入口、应用和恢复路径
1. 明确本文的部署约定
本文使用以下示例,请在执行前统一替换域名和发布版本:
| 对象 | 示例值 | 用途 |
|---|---|---|
| 操作系统 | Ubuntu 24.04 LTS | 使用 apt、systemd 和 Ubuntu 的 Nginx 目录结构 |
| 网站域名 | www.example.com | DNS、Nginx 与证书使用同一个名称 |
| 发布目录 | /srv/a5site/releases/20260701-01 | 存放代码及独立虚拟环境 |
| 当前版本链接 | /srv/a5site/current | 指向正在运行的发布目录 |
| 应用入口 | wsgi:app | 项目中的 WSGI 对象 |
| 应用监听地址 | 127.0.0.1:8080 | 只接受本机访问 |
| 服务名称 | a5site.service | systemd 管理对象 |
| 健康检查 | /healthz | 正常时返回 HTTP 200 |
| 持久化目录 | /var/lib/a5site | 存放上传文件等可写数据 |
应用应已完成测试,requirements.txt 包含适配 Python 3.12 的依赖和已验证版本的 Gunicorn。健康检查应快速返回,不泄露数据库连接串、环境变量或其他敏感信息。
本文针对新建服务器或新增独立站点。已有生产站点不能直接覆盖配置,也不要顺手卸载其他 Web 服务。
2. 核对 DNS、网络和系统
域名的 A 记录应指向服务器公网 IPv4。只有服务器确实配置了公网 IPv6,并且 IPv6 的 80、443 端口可达时,才保留 AAAA 记录。错误的 AAAA 记录可能造成部分用户访问失败,也可能影响证书验证。
先确认系统及监听状态:
cat /etc/os-release
systemctl --version
sudo ss -lntp
timedatectl status
80、443 已被其他服务占用时,应先确定现有业务,不能直接结束进程。
在服务商安全组和主机防火墙中分别核对:
- TCP 80、443 允许网站访问;使用 HTTP-01 申请及续期证书时,80 端口需要持续可达。
- SSH 管理端口只允许可信来源,具体端口以实际配置为准。
- 8080 不对公网放行,数据库端口也不对公网开放。
远程调整防火墙可能切断管理连接。 修改前导出现有规则,准备控制台或救援入口,保留当前 SSH 会话;确认第二个会话能够重新登录后再结束旧连接。不要在不了解现有规则的情况下直接启用、重置防火墙。
A5数据提供美国物理服务器租用,常规Xeon系列提供CN2 GIA线路方案,AMD EPYC系列提供大内存与NVMe存储配置,为Linux网站的Nginx入口、应用进程及数据库提供计算和存储基础。围绕企业官网、跨境业务后台和接口服务,不同档位的处理器、内存与磁盘资源支持独立站点及多应用部署,为程序运行、业务数据存储和日志留存提供资源支撑。
3. 安装软件并备份配置
下面的服务器端命令在同一个 root Bash 会话中执行。先进入管理会话,再安装组件:
sudo -i
apt update
apt install -y nginx python3-venv python3-pip certbot curl dnsutils
nginx -v
python3 --version
certbot --version
安装软件可能启动 Nginx,因此应先完成端口核对。
修改配置前建立只允许 root 访问的备份目录:
umask 077
B="/root/a5site-before-$(date +%Y%m%d-%H%M%S)"
install -d -m 0700 "$B"
tar -czf "$B/nginx.tar.gz" -C / etc/nginx
if [ -f /etc/systemd/system/a5site.service ]; then
cp -a /etc/systemd/system/a5site.service "$B/"
fi
if [ -d /etc/a5site ]; then
cp -a /etc/a5site "$B/"
fi
printf '备份目录:%s\n' "$B"
记录输出路径。后面的恢复操作会使用它。如果同名服务、站点配置已经存在,应先审查差异,而不是直接覆盖。
二、部署应用:使用独立账户和 systemd 守护
1. 放置代码,分离只读程序与可写数据
创建不允许交互登录的应用账户:
if ! id a5site >/dev/null 2>&1; then
useradd --system --user-group \
--home-dir /var/lib/a5site \
--shell /usr/sbin/nologin a5site
fi
install -d -o root -g root -m 0755 /srv/a5site/releases
install -d -o a5site -g a5site -m 0750 /var/lib/a5site
install -d -o root -g root -m 0700 /etc/a5site
将经过审核的发布包解压到 /srv/a5site/releases/20260701-01。发布目录由部署账户管理,运行账户只需要读取代码和执行程序,不应获得修改代码的权限。
代码和可写数据分离后,切换版本不会覆盖上传文件,也能减少应用被入侵后篡改程序的机会。
确认项目文件存在,再创建虚拟环境:
test -f /srv/a5site/releases/20260701-01/requirements.txt
test -f /srv/a5site/releases/20260701-01/wsgi.py
python3 -m venv /srv/a5site/releases/20260701-01/venv
/srv/a5site/releases/20260701-01/venv/bin/python -m pip install \
-r /srv/a5site/releases/20260701-01/requirements.txt
依赖安装属于代码执行环节,应使用可信发布包和经过审核的依赖。不要让生产服务器临时安装未经验证的“最新版本”。
首次部署且 current 尚不存在时,建立链接:
ln -s /srv/a5site/releases/20260701-01 /srv/a5site/current
如果该路径已经存在,不要用强制覆盖命令继续执行,应按后文的版本切换流程处理。
2. 配置环境变量与进程守护
创建环境文件,已有文件则保留:
if [ ! -e /etc/a5site/app.env ]; then
install -o root -g root -m 0600 /dev/null /etc/a5site/app.env
fi
使用编辑器写入应用实际需要的配置。环境文件采用 KEY=value 格式,不使用 export。示例变量只有在应用确实读取时才生效:
APP_ENV=production
DATA_DIR=/var/lib/a5site
密钥、数据库密码不要写入代码仓库或公开命令记录。环境文件由 systemd 在启动服务时读取,不需要为了让应用读取它而放宽文件权限。
创建 /etc/systemd/system/a5site.service:
[Unit]
Description=A5 site application
After=network.target
StartLimitIntervalSec=60
StartLimitBurst=5
[Service]
Type=simple
User=a5site
Group=a5site
WorkingDirectory=/srv/a5site/current
EnvironmentFile=/etc/a5site/app.env
Environment=PYTHONDONTWRITEBYTECODE=1
Environment=PYTHONUNBUFFERED=1
ExecStart=/srv/a5site/current/venv/bin/gunicorn \
--bind 127.0.0.1:8080 \
--workers 2 \
--timeout 30 \
--graceful-timeout 30 \
--error-logfile - \
--capture-output \
wsgi:app
Restart=on-failure
RestartSec=3
KillSignal=SIGTERM
TimeoutStopSec=45
NoNewPrivileges=true
PrivateTmp=true
ProtectHome=true
ProtectSystem=strict
ReadWritePaths=/var/lib/a5site
MemoryAccounting=true
MemoryHigh=768M
MemoryMax=1G
TasksMax=128
StandardOutput=journal
StandardError=journal
SyslogIdentifier=a5site
[Install]
WantedBy=multi-user.target
这是一个面向约 2 vCPU、4 GiB 内存服务器的起始示例,不是通用容量标准:
- 两个 worker 适合先建立可用基线,是否增加应看请求耗时、CPU 和内存占用。
MemoryHigh超限后会产生内存回收压力;MemoryMax是硬边界,超过后可能触发该服务内的 OOM 处理。ProtectSystem=strict限制文件写入,只有/var/lib/a5site被明确开放。应用如果还需要其他持久化写入路径,应逐项添加,不能直接关闭保护。Restart=on-failure处理异常退出,但不能修复错误依赖、错误配置或数据库故障。- Gunicorn 的超时与 worker 类型有关,不能简单当作所有业务请求的统一时限。
加载并启动:
systemd-analyze verify /etc/systemd/system/a5site.service
systemctl daemon-reload
systemctl enable --now a5site
systemctl status a5site --no-pager
curl -i http://127.0.0.1:8080/healthz
此处应先得到 HTTP 200,再继续配置 Nginx。应用自身没有启动时,调整反向代理无法解决问题。
三、配置 Nginx:先验证 HTTP,再启用 HTTPS
1. 建立访问日志和 HTTP 入口
在 /etc/nginx/conf.d/a5site-log.conf 中定义日志格式:
log_format a5site_json escape=json
'{"time":"$time_iso8601",'
'"remote":"$remote_addr",'
'"method":"$request_method",'
'"uri":"$uri",'
'"status":$status,'
'"request_time":$request_time,'
'"upstream_time":"$upstream_response_time",'
'"upstream_status":"$upstream_status"}';
这里记录 $uri,不记录查询参数,可降低令牌等敏感信息进入日志的风险。路径本身也不应携带密码或令牌。Ubuntu 软件包的默认配置会在 http 上下文中加载 conf.d;如果主配置已被改造,可用 nginx -T 核对。
创建 /etc/nginx/sites-available/a5site.conf:
server {
listen 80;
server_name www.example.com;
access_log /var/log/nginx/a5site.access.log a5site_json;
error_log /var/log/nginx/a5site.error.log warn;
client_max_body_size 10m;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
}
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Connection "";
proxy_connect_timeout 3s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;
}
}
这个配置面向普通 HTTP 网站,不包含长连接、实时推送或超大文件上传。10m 是示例上传边界,应与应用限制一致;proxy_read_timeout 控制相邻读取操作之间的等待时间,不等于整个请求的总时长。
本文按 Nginx 直接面对公网配置,因此覆盖客户端提交的转发头,避免把伪造地址传给应用。应用应只信任来自本机 Nginx 的这些头。如果前面增加 CDN 或负载均衡,需要根据其可信来源范围另行配置真实地址解析,不能直接信任任意客户端头。
启用站点:
install -d -o root -g root -m 0755 /var/www/acme
ln -s /etc/nginx/sites-available/a5site.conf \
/etc/nginx/sites-enabled/a5site.conf
nginx -t && systemctl reload nginx
不要为了启用新站点删除其他站点。默认站点也不必删除,匹配域名的请求会进入对应虚拟主机。
验证本机入口:
curl -i -H 'Host: www.example.com' http://127.0.0.1/healthz
随后从服务器之外访问同一个 HTTP 地址,确认公网链路正常。
2. 申请证书,再切换到 HTTPS
先核对 DNS:
dig +short A www.example.com
dig +short AAAA www.example.com
创建临时验证文件:
install -d -m 0755 /var/www/acme/.well-known/acme-challenge
printf 'acme-path-ok\n' \
> /var/www/acme/.well-known/acme-challenge/a5-check.txt
从外部电脑执行:
curl -i http://www.example.com/.well-known/acme-challenge/a5-check.txt
应返回 acme-path-ok。若域名经过 CDN,应同时确认该路径能够回源,不被认证、缓存规则或访问控制拦截。
使用 Webroot 模式申请证书,不让工具自动改写站点配置:
certbot certonly \
--webroot -w /var/www/acme \
--cert-name a5site \
-d www.example.com
按提示填写邮箱并确认服务条款。成功后检查实际路径:
certbot certificates
下面按证书名称 a5site 示例配置。如果输出中的证书目录不同,应使用实际路径。
修改前再保存当前 HTTP 配置:
cp -a /etc/nginx/sites-available/a5site.conf "$B/a5site-http.conf"
将站点配置替换为:
server {
listen 80;
server_name www.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
}
location / {
return 301 https://www.example.com$request_uri;
}
}
server {
listen 443 ssl;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/a5site/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/a5site/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
access_log /var/log/nginx/a5site.access.log a5site_json;
error_log /var/log/nginx/a5site.error.log warn;
client_max_body_size 10m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Connection "";
proxy_connect_timeout 3s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;
}
}
执行:
nginx -t && systemctl reload nginx
使用 reload 可减少对现有连接的影响。语法检查失败时不要继续重启,应先修正配置或恢复备份。首次上线也不急于启用长期 HSTS 策略,避免 HTTPS 尚未验证完整就让客户端长期记住强制访问规则。
3. 配置续期后的证书加载
证书续期成功后,Nginx 还需要重新加载。创建 /etc/letsencrypt/renewal-hooks/deploy/a5site-reload-nginx.sh:
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
赋予脚本执行权限并核验定时任务:

chmod 0750 /etc/letsencrypt/renewal-hooks/deploy/a5site-reload-nginx.sh
systemctl enable --now certbot.timer
systemctl list-timers certbot.timer
certbot renew --dry-run
如果同名脚本已经存在,先备份和审查内容。Ubuntu apt 安装方式使用这里的定时任务;其他安装方式应核对实际调度机制,避免重复执行。
--dry-run 成功表示续期验证链路可用,不代表已经证明部署钩子执行成功。另行手动运行一次脚本,并检查 Nginx 状态:
/etc/letsencrypt/renewal-hooks/deploy/a5site-reload-nginx.sh
systemctl is-active nginx
四、上线后的保护:日志、备份和资源边界
1. 让日志能区分入口故障和应用故障
Nginx 访问日志负责记录响应状态、总处理时间和上游响应时间;错误日志用于查看连接拒绝、超时、权限等问题;应用日志保留异常堆栈与业务错误。
常用查看命令:
tail -n 50 /var/log/nginx/a5site.error.log
tail -n 20 /var/log/nginx/a5site.access.log
journalctl -u a5site -n 100 --no-pager
journalctl --disk-usage
如果总处理时间长、上游时间也长,应优先检查应用及其依赖;如果应用本机响应正常,而外部浏览器仍然慢,需要继续检查网络路径、静态资源和前端请求,不能仅靠增加 worker 判断。
核对 Ubuntu 的 Nginx 日志轮转配置是否覆盖 /var/log/nginx/*.log:
cat /etc/logrotate.d/nginx
logrotate -d /etc/logrotate.conf
df -h
df -i
logrotate -d 只检查,不实际轮转。保留周期应结合磁盘和审计需求设置;修改既有轮转配置前先备份,不要通过删除全部日志来临时释放空间。
2. 备份配置、程序和业务数据
至少区分三类备份:
| 内容 | 备份方式 | 恢复时要核对 |
|---|---|---|
| Nginx、systemd、环境文件、证书 | 受限目录归档并复制到异机 | 权限、证书私钥、配置语法 |
| 发布程序 | 保留上一发布目录和可信发布包 | 依赖完整性、入口与环境兼容性 |
| 数据库、上传文件 | 数据库原生备份及一致性文件备份 | 数据版本、事务一致性、恢复结果 |
配置和程序可按以下方式归档:
umask 077
install -d -m 0700 /root/a5site-backups
tar -czf "/root/a5site-backups/config-code-$(date +%Y%m%d-%H%M%S).tar.gz" \
-C / \
etc/nginx \
etc/systemd/system/a5site.service \
etc/a5site \
etc/letsencrypt \
srv/a5site
归档包含环境变量和证书私钥,必须限制访问,异机传输和存储应加密。服务器本地备份只是恢复便利措施,不能替代异机副本。
不要把正在写入的数据库目录直接打包后当作可靠备份。数据库应使用对应引擎的备份工具;上传文件应结合应用写入策略做一致性备份。涉及停写或停机时,要明确影响范围和恢复服务的步骤。
3. 给资源设置边界,但不把限制当作扩容
查看当前服务资源:
systemctl show a5site \
-p MemoryCurrent \
-p MemoryHigh \
-p MemoryMax \
-p TasksCurrent \
-p NRestarts
free -h
df -h
应用频繁触及内存硬限制时,先检查 worker 数量、单次任务占用和是否存在泄漏。放大限制之前,应确认 Nginx、系统和数据库仍有余量。
进程守护不等于高可用:服务器宕机、磁盘满或整机资源耗尽时,systemd 不能把网站迁移到另一台机器。单机部署应配套外部可用性监测和恢复流程。
五、结果验证与常见失败处理
1. 按从本机到公网的顺序验收
先检查服务状态与端口:
systemctl is-enabled a5site nginx certbot.timer
systemctl is-active a5site nginx
ss -lntp
预期应用只监听 127.0.0.1:8080,Nginx 监听网站端口。若应用监听成 0.0.0.0:8080,应修正启动参数,而不是只依赖安全组阻挡。
再检查各层响应:
curl -fsS http://127.0.0.1:8080/healthz
curl --resolve www.example.com:443:127.0.0.1 \
-fsS https://www.example.com/healthz
第二条命令绕过公网 DNS,但仍会验证域名和证书。不要加 -k,否则会掩盖证书错误。
从外部电脑检查:
curl -I http://www.example.com/
curl -I https://www.example.com/
curl -fsS https://www.example.com/healthz
HTTP 应跳转到 HTTPS,HTTPS 应无证书错误。然后实际验证登录、上传、数据库读写等核心功能;健康检查返回 200 不代表所有业务路径正常。
美国服务器面向其他地区用户时,应从目标用户所在地完成外部验证。服务器本机请求不能反映跨地区网络质量。

2. 由外到内排查,不先重启全部服务
| 现象 | 优先检查 | 结果含义 |
|---|---|---|
| 域名解析不到正确地址 | A、AAAA、DNS 缓存 | 请求可能尚未到达服务器 |
| 外部连接超时,本机正常 | 安全组、主机防火墙、网络路径 | 入口被拦截或链路异常 |
| Nginx 返回 502 | 8080 监听和应用日志 | 应用未启动、连接拒绝或上游异常退出 |
| Nginx 返回 504 | Nginx 错误日志、应用依赖耗时 | 上游未及时返回,需要定位慢操作 |
| 返回 413 | Nginx 和应用上传限制 | 请求体超过允许大小 |
| HTTPS 跳转循环 | 转发协议头和应用代理信任设置 | 应用误判原始请求协议 |
| 证书申请失败 | 公网 80、验证文件、AAAA、CAA | 验证路径或签发条件不满足 |
| 服务不断重启 | journal、资源限制、启动命令 | 守护程序正在重复遇到同一故障 |
应用故障先看日志:
journalctl -u a5site --since "15 minutes ago" --no-pager
systemctl status a5site --no-pager
常见结果分别处理:
ModuleNotFoundError:核对项目入口、工作目录和虚拟环境依赖。Permission denied:检查具体路径权限及 systemd 写入限制,不要递归设置777。Address already in use:查明占用 8080 的进程,不要直接杀死未知服务。start-limit-hit:先修复失败原因,再解除启动限制。- 内存相关退出:结合服务日志和内核日志判断,不要只凭退出码推断。
修复原因后再执行:
systemctl reset-failed a5site
systemctl restart a5site
curl -fsS http://127.0.0.1:8080/healthz
应用重启可能短暂中断请求,应在维护窗口执行。它不是无影响的健康检查手段。
六、发布失败时回滚,并完成上线检查
1. 配置回滚:只恢复改动对象
Nginx HTTPS 配置出现问题时,可恢复之前的 HTTP 配置:
cp -a "$B/a5site-http.conf" /etc/nginx/sites-available/a5site.conf
nginx -t && systemctl reload nginx
这个操作会让站点暂时恢复 HTTP,不适合继续承载登录、支付等敏感操作。更合适的生产处理通常是恢复上一份可用 HTTPS 配置。不要因为一个站点失败就恢复整套 Nginx 目录,除非确认没有其他站点在备份之后发生变更。
systemd 配置错误时,恢复先前备份的单元文件,再执行 daemon-reload 和服务重启。首次部署没有旧服务可恢复时,可停止新应用,但不要连带停止承载其他网站的 Nginx。
2. 程序回滚:保留旧目录,原子切换链接
常规发布应先准备新目录和依赖,再切换 current。发布前记录旧版本:
OLD_RELEASE="$(readlink -f /srv/a5site/current)"
printf '%s\n' "$OLD_RELEASE"
将该路径写入发布记录。切换新版本时:
ln -s /srv/a5site/releases/20260701-02 /srv/a5site/current.next
mv -Tf /srv/a5site/current.next /srv/a5site/current
systemctl restart a5site
curl -fsS http://127.0.0.1:8080/healthz
这组操作要求 current 是符号链接、current.next 不存在,且新发布目录已经准备完整。mv -Tf 会替换当前版本链接,影响整个应用;执行前必须确认旧路径并保留旧目录。
新版本验证失败时:

ln -s "$OLD_RELEASE" /srv/a5site/current.rollback
mv -Tf /srv/a5site/current.rollback /srv/a5site/current
systemctl restart a5site
curl -fsS http://127.0.0.1:8080/healthz
回滚临时链接也必须不存在,OLD_RELEASE 必须指向仍然完整的旧版本。跨会话操作时,应从发布记录重新取得旧路径。
代码回滚不会自动回滚数据库。 如果新版本执行了不向后兼容的数据库迁移,旧代码可能无法运行。涉及表结构变更的发布,应提前设计兼容窗口、备份及数据恢复方案,不能把切换符号链接当作完整恢复。
3. 上线验收检查清单
- [ ] 系统版本、应用入口和依赖版本已核对,示例域名已全部替换。
- [ ] A 记录正确,AAAA 仅在 IPv6 确实可用时保留。
- [ ] 网站入口允许访问,SSH 来源受限,8080 和数据库端口未暴露公网。
- [ ] 应用以独立账户运行,代码只读,可写数据目录范围明确。
- [ ] systemd 开机启动正常,重启后的健康检查已在维护窗口验证。
- [ ] Nginx 配置检查通过,HTTP 跳转、HTTPS 和核心业务功能正常。
- [ ] 证书名称及文件路径正确,续期演练通过,加载钩子已验证。
- [ ] 应用只信任本机 Nginx 提供的转发头,不信任任意公网客户端头。
- [ ] 访问日志、错误日志、应用日志可读,轮转和磁盘告警已确认。
- [ ] 配置、程序和业务数据有对应备份,至少完成一次恢复演练。
- [ ] 旧版本目录、回滚路径和数据库迁移边界已记录。
- [ ] 已从目标用户所在地验证公网访问,并设置外部可用性与证书到期告警。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3110.html



