美国服务器部署Linux网站,Nginx、证书与进程守护怎么配置

发布人:A5数据发布时间:2026-10-10 13:49阅读量:190

部署完成后,网站应达到这样的状态:公网只开放网站所需的 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.comDNS、Nginx 与证书使用同一个名称
发布目录/srv/a5site/releases/20260701-01存放代码及独立虚拟环境
当前版本链接/srv/a5site/current指向正在运行的发布目录
应用入口wsgi:app项目中的 WSGI 对象
应用监听地址127.0.0.1:8080只接受本机访问
服务名称a5site.servicesystemd 管理对象
健康检查/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 返回 5028080 监听和应用日志应用未启动、连接拒绝或上游异常退出
Nginx 返回 504Nginx 错误日志、应用依赖耗时上游未及时返回,需要定位慢操作
返回 413Nginx 和应用上传限制请求体超过允许大小
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

相关推荐