如何在韩国服务器上批量部署网站,并保持各站点配置独立?
已有韩国服务器正在承载多个网站时,批量部署的重点不是把同一份目录复制多次,而是把可复用的部署流程与每个站点自己的配置分开管理。代码版本可以统一批次发布;域名、站点目录、运行用户、环境变量、数据库连接、日志和定时任务则应按站点分别维护。
可在现有环境中用 Ansible 等工具读取站点清单,逐站生成配置、部署新版本并检查结果。发布前保存当前配置和版本,发布后先验证 Nginx 配置,再检查各站点响应;某个站点失败时,只回退该站点的变更。以下以已安装 Nginx、使用 systemd 的 Linux 服务器为例,重点是日常批量维护,不涉及从零安装服务器。
先确认现有环境与隔离边界
开始调整前,先确认服务器上的发行版、Nginx 配置入口、站点目录和服务状态。Debian、Ubuntu 常见配置入口包括 sites-enabled,部分发行版则使用 conf.d;不要在未检查主配置的情况下直接假设路径。
cat /etc/os-release
nginx -V 2>&1
nginx -T
systemctl status nginx --no-pager
timedatectl
nginx -T 会展开主配置和被包含的站点配置,可能包含敏感信息。只在受控终端查看,不要把完整输出粘贴到公开工单、聊天记录或普通部署日志中。
配置独立不等于进程或资源完全隔离。多个站点可以共用 Nginx 进程和操作系统,但应避免把站点的可变信息写进一份难以追踪的公共配置。若站点之间存在不同的权限或风险要求,还需要单独的系统用户、运行时池、数据库账号和凭据;仅拆分虚拟主机文件不能形成安全隔离。

| 项目 | 建议的站点级边界 | 核对方式 |
|---|---|---|
| 文件 | 各自的发布版本、当前版本链接和持久化目录 | readlink -f 检查当前版本路径 |
| Web 配置 | 每站点单独的虚拟主机文件 | nginx -T 检查域名、根目录和日志路径 |
| 权限 | 每站点独立运行用户;至少避免其他站点可写 | 检查目录属主、属组和权限位 |
| 应用配置 | 每站点单独的环境变量和密钥文件 | 确认密钥不进入代码仓库和发布包 |
| 数据库 | 按站点分开账号和授权范围 | 用对应账号验证连接,不以管理员账号代替 |
| 定时任务 | 各站点独立命令、运行用户和日志 | 检查计划任务、锁文件和执行记录 |
韩国服务器的具体时区、网络出口和资源配额,应以当前主机配置和业务要求为准。不要仅因服务器位于韩国就直接修改整台主机的时区或防火墙规则;这类调整可能影响所有站点和既有任务。
A5idc数据提供韩国首尔及香港、日本、新加坡等地区的物理服务器资源,覆盖不同CPU、内存、磁盘和网络线路组合,可为批量建站场景提供相对独立的主机资源基础。针对多站点并行维护,可结合SSD或NVMe存储承载站点文件、版本目录与日志,并依据访问地区和业务负载匹配相应线路,便于将各站点的配置、内容和运行任务分开规划。
日常操作:用清单驱动重复部署
1. 维护站点清单
将站点的固定属性集中在清单中,将部署版本、变更编号等每次发布才变化的内容作为单独变量传入。清单应进入版本管理,但密钥、数据库密码和私钥应从受控的密钥管理方式读取,不要明文提交。
下面是一个仅用于说明字段关系的 YAML 示例:
sites:
- id: shop-a
domain: shop-a.example.kr
root: /srv/www/shop-a
runtime_user: shop-a
app_type: static
timezone: Asia/Seoul
cron_enabled: true
- id: docs-b
domain: docs-b.example.kr
root: /srv/www/docs-b
runtime_user: docs-b
app_type: static
timezone: Asia/Seoul
cron_enabled: false
每个 id 应唯一,字符范围要适合目录名、配置文件名和日志文件名;域名、站点根目录和运行用户也应分别核实。应用类型不同的站点不能机械套用相同的运行配置,例如静态站点和 PHP 应用的 Nginx 请求处理方式并不相同。
发布目录可以采用如下布局:
/srv/www/shop-a/
├── releases/
│ ├── 20250621-01/
│ └── 20250628-01/
├── shared/
│ └── .env
└── current -> releases/20250628-01
新版本先写入独立的 releases 目录,检查通过后再切换 current。上传新包时不要覆盖正在服务的目录;这样即使新版本检查失败,旧目录仍然保留。shared 只存放确实需要跨版本保留的数据,并按站点分别授权。

2. 按站点模板生成虚拟主机
如果现有 Nginx 已包含 /etc/nginx/conf.d/*.conf,可以为每个站点生成独立文件。下面的模板适用于静态站点;它不包含 TLS 配置,也不应直接作为 PHP 应用的完整配置。
server {
listen 80;
server_name {{ site.domain }};
root {{ site.root }}/current/public;
index index.html;
access_log /var/log/nginx/{{ site.id }}.access.log;
error_log /var/log/nginx/{{ site.id }}.error.log warn;
location / {
try_files $uri $uri/ =404;
}
}
模板路径、server_name 和日志文件名都从当前站点数据生成。上线前确认每个域名只落入预期的站点配置,根目录真实存在,Nginx 运行用户能够读取站点文件,但不能无必要地写入代码目录。生产站点还应按现有证书管理方式配置 HTTPS,并逐站确认域名与证书匹配。
3. 用 Ansible 执行可重复的配置更新
对现有虚拟主机进行维护时,可用 Ansible 循环处理站点清单,并在每站点变更前保存当前配置。下面示例假设当前站点配置文件已存在,Nginx 主配置包含 /etc/nginx/conf.d/*.conf,模板文件名为 templates/site.conf.j2。
主任务文件 deploy-sites.yml:
- name: Update website configurations
hosts: korea_web
become: true
vars_files:
- vars/sites.yml
tasks:
- name: Check site identifiers are unique
ansible.builtin.assert:
that:
- sites | length > 0
- (sites | map(attribute='id') | list | unique | length) == (sites | length)
fail_msg: "Site list is empty or contains duplicate identifiers."
- name: Apply each site's configuration
ansible.builtin.include_tasks: tasks/apply-site.yml
loop: "{{ sites }}"
loop_control:
loop_var: site
tasks/apply-site.yml:

- name: Check the site identifier format
ansible.builtin.assert:
that:
- site.id is match('^[a-z0-9][a-z0-9-]{0,31}$')
- site.domain is defined
- site.root is defined
- name: Create the backup directory
ansible.builtin.file:
path: /var/backups/nginx-sites
state: directory
owner: root
group: root
mode: "0700"
- name: Save the current site configuration
ansible.builtin.copy:
src: "/etc/nginx/conf.d/{{ site.id }}.conf"
dest: "/var/backups/nginx-sites/{{ site.id }}.{{ change_id }}.conf"
remote_src: true
owner: root
group: root
mode: "0600"
- name: Update and validate the site configuration
block:
- name: Render the site configuration
ansible.builtin.template:
src: templates/site.conf.j2
dest: "/etc/nginx/conf.d/{{ site.id }}.conf"
owner: root
group: root
mode: "0644"
- name: Test all Nginx configuration files
ansible.builtin.command:
argv:
- nginx
- -t
changed_when: false
- name: Reload Nginx after successful validation
ansible.builtin.service:
name: nginx
state: reloaded
rescue:
- name: Restore the saved site configuration
ansible.builtin.copy:
src: "/var/backups/nginx-sites/{{ site.id }}.{{ change_id }}.conf"
dest: "/etc/nginx/conf.d/{{ site.id }}.conf"
remote_src: true
owner: root
group: root
mode: "0644"
- name: Confirm the restored configuration is valid
ansible.builtin.command:
argv:
- nginx
- -t
changed_when: false
- name: Stop the deployment after restoring the configuration
ansible.builtin.fail:
msg: "Site {{ site.id }} was restored; review the failed change before retrying."
change_id 应为每次变更唯一的标识,例如发布单号或时间戳。运行前先用只读检查和 Ansible check mode 查看计划:
ansible-playbook -i inventory deploy-sites.yml \
--limit korea_web \
--check \
--diff \
-e change_id=20250628-01
check mode 不能替代真实的 nginx -t,也不一定能完整模拟所有命令和模块的实际效果。确认差异后再执行实际变更:
ansible-playbook -i inventory deploy-sites.yml \
--limit korea_web \
-e change_id=20250628-01
示例按站点逐个更新并验证,因此批次中途失败时,前面已成功的站点可能保持新配置,失败站点则恢复原配置。执行结果需要按站点记录,不要仅依据整次任务的最终状态判断所有站点都已完成。若要一次性切换整批配置,应另行设计整批候选配置的验证和统一提交步骤。
4. 发布站点内容时保留旧版本
应用包应先解压到该站点的新版本目录,并检查目录结构、配置文件和应用自身的预检命令。确认新版本准备好后,更新站点的 current 链接,而不是删除旧版本再覆盖。
在同一文件系统内,将临时链接改名为 current 可缩短切换窗口。操作前记录当前链接指向,并确保发布脚本只处理指定站点的目录;不要用通配符跨站点删除目录。切换后立即访问站点健康检查地址或关键页面。如果检查失败,将 current 恢复到记录的旧版本,再重新检查站点响应。
版本回退只恢复代码和站点配置,不会自动撤销数据库结构变更。数据库迁移应优先采用新旧版本兼容的步骤;需要执行不可逆迁移时,先备份受影响的数据,并单独制定恢复方案。
5. 分开管理定时任务
每个站点的任务应有明确的运行用户、绝对路径、输出日志和防重入机制。以 /etc/cron.d 中的一条任务为例:
SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
17 * * * * shop-a /usr/bin/flock -n /srv/www/shop-a/shared/task.lock /usr/bin/php /srv/www/shop-a/current/bin/console app:task >> /var/log/shop-a/cron.log 2>&1
该格式包含运行用户,适用于 /etc/cron.d;如果使用用户自己的 crontab,格式不同,不要直接复制这行。执行前确认 shop-a 用户能够访问程序、锁文件目录和日志目录,且服务器安装了所需的 flock 与 PHP 命令。
先检查主机时区,再核对任务所要求的业务时间。若任务按韩国当地时间执行,应明确服务器调度时区和应用自身时区的关系;不要为单个站点随意修改全机时区,因为这会影响同机其他任务。对运行时间较长的任务,使用锁避免重叠执行,并分别查看任务退出码和站点日志。
结果检查:同时验证配置、响应和资源
每次变更后,按站点清单检查,不要只验证其中一个域名:
- 配置检查:
nginx -t返回成功;逐站确认域名、根目录、证书路径和日志路径指向正确配置。 - 服务检查:确认 Nginx 服务仍在运行,配置重载后没有新的错误日志。
- 站点检查:从服务器本机及适用的外部监测位置分别请求域名。可用
curl --resolve在指定地址测试某个虚拟主机,避免只测到默认站点。 - 版本检查:检查每个站点
current指向的版本与本次发布记录一致。 - 任务检查:核对定时任务的运行用户、最近执行时间、退出状态、日志增长情况及锁是否长期占用。
- 资源检查:观察磁盘空间和 inode、CPU、内存、连接数及日志增长。如果多个站点同时部署,应避免并发发布超过服务器和磁盘可承受范围。
如果站点使用不同的健康检查路径,应把路径与预期状态分别记录在站点清单或验收表中。首页返回成功不一定代表后台任务、数据库连接和业务关键功能均正常。
异常处理:先缩小影响范围,再决定是否回退
遇到问题时,先确定是单站点配置、应用版本、共享服务还是主机资源问题。不要一开始就重启整台服务器或批量回退所有站点。
nginx -t失败:检查错误信息指向的文件和行号。常见原因包括配置语法错误、重复监听或文件路径不存在。恢复该站点变更前的配置,再重新运行nginx -t;配置检查成功后再重载服务。- 重载后只有一个域名异常:核对该域名是否进入正确虚拟主机、
current是否指向正确版本、站点目录权限是否符合预期。若异常始于本次发布,优先回退该站点版本和配置。 - 多个站点同时异常:检查 Nginx 服务状态、共享配置、磁盘空间、文件系统和资源使用情况。此时不要盲目逐站重启应用,以免掩盖共同故障原因。
- 定时任务未运行或重复运行:先确认主机时区、计划任务格式、运行用户权限和命令绝对路径,再检查锁文件与任务日志。不要通过删除所有锁文件或扩大目录权限来掩盖原因。
- 回退后仍异常:核对是否存在数据库变更、共享配置变更或外部依赖变化。代码回退并不代表这些状态也已恢复;涉及数据的恢复应按单独备份和迁移计划执行。
回退前确认备份对应的站点和变更编号,确认操作范围只覆盖目标配置或版本。权限调整、防火墙变更、数据库写入和文件删除都应先说明影响对象,并保留可验证的恢复步骤。

必要恢复与审计记录
每次批量操作至少记录变更编号、执行人、目标主机、站点清单、代码版本、配置版本、备份位置、检查结果和回退结果。使用版本管理保存模板和非敏感清单;密钥备份应加密并限制访问。不要把 nginx -T、完整环境变量或包含凭据的差异内容直接写入公共审计日志。
恢复时按影响范围选择粒度:
- 配置错误且只有单站点受影响:恢复该站点的备份配置,运行
nginx -t,再重载 Nginx。 - 新版本发布后单站点异常:切回已记录的旧版本链接,检查站点响应和应用日志。
- 多站点共同受影响:先检查共享配置、服务状态和资源,再按变更记录恢复相关站点;确认范围之前不要批量覆盖配置。
- 数据库或持久化文件异常:按独立的数据备份和迁移方案处理,不以切换代码版本代替数据恢复。
上线或验收检查清单
- [ ] 站点清单中的 ID、域名、目录和运行用户均已核对,站点 ID 无重复。
- [ ] 每个站点的配置、日志、凭据和定时任务均有明确归属。
- [ ] 新版本写入独立发布目录,旧版本仍可用于回退。
- [ ] 站点模板与实际应用类型匹配,TLS 配置和证书按域名逐站验证。
- [ ] 配置变更前已有带变更编号的备份,
nginx -t成功后才重载服务。 - [ ] 每个域名均完成响应检查,定时任务和关键业务检查也有记录。
- [ ] 已确认回退范围、恢复路径和数据库变更边界,批次结果按站点留档。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9524.html
