在日本Linux服务器部署Shopware电商网站,需要哪些环境与上线步骤?

发布人:A5数据发布时间:2026-10-15 09:05阅读量:100

要在日本服务器上稳定上线 Shopware,目标不只是完成安装页面,而是让域名能够通过 HTTPS 访问店铺,后台可以登录,数据库、缓存、计划任务和媒体文件正常工作,并且在升级或故障时有可执行的备份与回滚路径。下面以单台日本 Linux 云服务器为例,采用 Debian 12、Nginx、PHP 8.2-FPM、MariaDB 10.11 和 Shopware 6 为基线,适合中小规模店铺的初始部署。

这套环境需要先确认目标 Shopware 小版本支持 PHP 8.2 和 MariaDB 10.11。Shopware 版本、PHP 主版本和数据库版本不能只按“最新”安装,正式上线前应固定具体版本,并保存 composer.lock。如果目标版本要求 PHP 8.3 或其他数据库版本,应优先调整操作系统软件源和运行环境,不要通过强行替换系统组件解决兼容问题。

一、明确上线目标与服务器基线

1. 推荐的基础架构

典型请求链路如下:

一、明确上线目标与服务器基线配图

日本用户
   ↓
shop.example.jp
   ↓
日本服务器公网 IP
   ↓
Nginx + HTTPS
   ↓
PHP 8.2-FPM
   ↓
Shopware 6
   ↓
MariaDB 10.11

Redis 可以作为后续缓存或队列组件加入,但不建议在第一次安装时同时引入过多可选组件。先让核心商城、后台、数据库和定时任务稳定运行,再根据商品数量、访问量和异步任务情况扩展。

项目示例基线说明
地域日本机房面向日本客户时,通常有利于降低本地访问链路距离,但实际速度仍受运营商、线路和页面资源影响
操作系统Debian 12 64 位使用稳定的软件包版本,便于统一维护
CPU2 vCPU 起步商品导入、索引和图片处理较多时可增加到 4 vCPU
内存4 GB 起步PHP、数据库和索引任务共用内存;生产环境建议预留扩容空间
磁盘SSD,40 GB 起步系统、代码、数据库和媒体文件共同占用,图片较多时应单独估算
Web 服务Nginx负责 HTTPS、静态文件和 PHP 请求转发
PHP8.2-FPM以目标 Shopware 版本兼容矩阵为准
数据库MariaDB 10.11使用本机连接时延迟较低,生产环境应单独备份
域名shop.example.jp示例域名,需要替换为实际域名
时区Asia/Tokyo影响日志、计划任务和后台时间显示,不会自动设置店铺币种或语言

如果商城需要大量商品、复杂筛选、批量导入或多个销售渠道,4 GB 内存可能很快变得紧张。此时可考虑 4 vCPU、8 GB 内存,或将数据库、搜索服务和应用服务拆分。配置值属于部署起点,不代表固定容量结论。

针对日本 Linux 服务器上的 Shopware 电商部署,A5数据提供日本物理服务器资源,覆盖 Xeon Gold、AMD EPYC、NVMe 存储及不同内存配置,可为应用服务、数据库、商品图片与缓存等运行环境提供硬件基础。日本产品还提供热销系列与 CTG 系列,并配备 CN2、国际带宽及 CIA、GIA、SoftBank 等线路选项,适配日本本地访问、跨境业务和多业务并行运行场景。

2. 上线前必须准备的条件

正式执行命令前,准备以下信息:

  • 服务器公网 IPv4;如果配置了 IPv6,还要确认 Nginx、防火墙和供应商网络都支持 IPv6。
  • 一个已经备案或可正常解析的域名,例如 shop.example.jp。
  • 目标 Shopware 的明确版本号,例如 6.x.y,不要在生产服务器上直接使用未锁定的浮动版本。
  • 数据库名、数据库用户名和随机生成的数据库密码。
  • 后台管理员邮箱和高强度密码。
  • SSH 密钥登录方式,以及云厂商控制台或带外终端。
  • 备份存储位置。数据库备份不应只放在同一台服务器上。
  • 支付、邮件、物流和税率等业务资料。它们通常不属于 Linux 安装步骤,但会影响验收。

3. 先确定域名解析策略

将域名的 A 记录指向日本服务器 IPv4:

shop.example.jp.    A       203.0.113.20

203.0.113.20 只是示例地址,需要替换为实际公网 IP。如果 DNS 中存在 AAAA 记录,但服务器没有正确配置 IPv6,应先删除或暂时停用该记录,否则部分访问者可能被解析到不可用的 IPv6 地址。

可以从本地或其他网络检查解析:

dig +short A shop.example.jp
dig +short AAAA shop.example.jp

解析结果正确后再申请证书。证书申请阶段通常需要域名能够从公网访问服务器的 80 或 443 端口。

二、初始化 Debian 服务器

1. 更新系统并设置日本时区

通过 SSH 登录后,确认当前系统和内核:

cat /etc/os-release
uname -a

确认确实是 Debian 12 后执行更新:

apt update
apt full-upgrade -y
apt install -y ca-certificates curl wget unzip git vim-tiny \
  gnupg lsb-release software-properties-common

如果内核、OpenSSL 或关键系统库发生更新,建议安排维护窗口重启:

reboot

重启会中断当前连接和正在处理的请求。生产环境执行前应确认没有正在进行的订单导入、数据库备份或后台任务。

设置时区并检查时间同步:

timedatectl set-timezone Asia/Tokyo
timedatectl status

输出中的 System clock synchronized: yes 表示时间同步正常。时间不准确可能导致 HTTPS 证书验证、订单时间、计划任务和日志排序出现问题。

2. 建立基础安全边界

先确认当前 SSH 会话可以使用密钥登录,再考虑限制密码登录或禁止 root 远程登录。不要在尚未验证新账号和密钥之前直接关闭 root 或密码登录,否则可能把自己锁在服务器外。

如果使用 UFW 管理防火墙,先确认 SSH 端口,再放行 SSH、HTTP 和 HTTPS:

apt install -y ufw

# 22 仅为示例;如果 SSH 使用其他端口,应替换为实际端口
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp

ufw status verbose
ufw enable
ufw status numbered

防火墙操作提示:启用防火墙前应保留云厂商控制台或带外终端,并备份当前规则。必须先放行实际 SSH 端口,再执行 ufw enable。如果配置错误,可通过控制台执行 ufw disable 作为回滚;不要在唯一 SSH 会话中盲目修改规则。

二、初始化 Debian 服务器配图

若云厂商提供安全组,建议同时限制入站端口:

  • SSH:仅允许办公网或运维跳板机来源地址。
  • 80/TCP:用于 HTTP 访问和证书验证。
  • 443/TCP:用于 HTTPS。
  • 数据库端口:不对公网开放。
  • Redis 端口:不对公网开放。

三、安装 PHP、Nginx 和数据库

1. 安装 PHP 8.2 及 Shopware 常用扩展

Debian 12 默认提供 PHP 8.2 软件包,可以安装 PHP-FPM、命令行工具和常用扩展:

apt install -y nginx mariadb-server mariadb-client composer \
  php8.2-cli php8.2-fpm php8.2-common \
  php8.2-curl php8.2-gd php8.2-intl php8.2-mbstring \
  php8.2-mysql php8.2-opcache php8.2-xml php8.2-zip \
  php8.2-bcmath php8.2-soap php8.2-redis

检查版本和扩展:

php -v
php -m | sort
systemctl status php8.2-fpm --no-pager

重点确认以下扩展存在:

ctype
curl
dom
fileinfo
gd
intl
mbstring
openssl
PDO
pdo_mysql
SimpleXML
xml
zip
opcache

redis 不是所有基础安装都必须使用。如果系统仓库没有对应的 php8.2-redis 包,可以暂时不安装 Redis 扩展,先完成不依赖 Redis 的基础部署。

2. 设置 PHP 生产参数

新建独立配置文件,避免直接修改发行版主配置:

cat > /etc/php/8.2/fpm/conf.d/99-shopware.ini <<'EOF'
memory_limit = 512M
upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 120
max_input_time = 120
max_input_vars = 5000
date.timezone = Asia/Tokyo

opcache.enable = 1
opcache.memory_consumption = 256
opcache.interned_strings_buffer = 16
opcache.max_accelerated_files = 20000
opcache.validate_timestamps = 0
EOF

opcache.validate_timestamps = 0 适合代码已经固定的生产环境,但代码更新后必须重启 PHP-FPM,否则旧代码可能继续驻留在缓存中。开发环境不建议使用该值。

检查配置并重启 PHP-FPM:

php-fpm8.2 -t
systemctl restart php8.2-fpm
systemctl enable php8.2-fpm

重启 PHP-FPM 会短暂中断正在处理的 PHP 请求,适合在部署窗口内执行。

3. 创建 MariaDB 数据库

先启动并设置开机自启:

systemctl enable --now mariadb
systemctl status mariadb --no-pager

执行基础安全检查:

mariadb-secure-installation

根据提示删除匿名用户、禁止远程 root 登录、删除测试数据库。该命令会修改数据库认证和默认对象,执行前应确认没有依赖匿名用户或远程 root 的旧业务。

进入 MariaDB 创建数据库和专用账号:

mariadb -u root -p

在 MariaDB 控制台中执行:

CREATE DATABASE shopware
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

CREATE USER 'shopware'@'127.0.0.1'
  IDENTIFIED BY '请替换为随机高强度密码';

GRANT ALL PRIVILEGES ON shopware.* TO 'shopware'@'127.0.0.1';

FLUSH PRIVILEGES;
EXIT;

测试账号是否可以连接:

mariadb \
  --host=127.0.0.1 \
  --user=shopware \
  --password \
  --database=shopware \
  --execute="SELECT VERSION(), DATABASE();"

数据库账号只允许从 127.0.0.1 登录,数据库服务不需要对公网开放。数据库密码不要直接写入公开脚本或提交到代码仓库。

四、部署 Shopware 文件和环境变量

1. 固定 Shopware 版本

Shopware 的具体小版本会影响 PHP 扩展、数据库和插件兼容性。先记录目标版本,例如:

export SHOPWARE_VERSION='6.x.y'

其中 6.x.y 只是占位符,必须替换为已经审核过的具体版本号。不要把下面的占位符原样执行。

确认 Composer 版本:

composer --version

如果项目已经存在,应使用项目中的 composer.json 和 composer.lock,不要重新创建一个未锁定版本的项目。

2. 创建项目目录并安装生产依赖

创建部署用户和目录。若服务器已有统一部署用户,应使用现有账号,不要重复创建:

adduser --disabled-password --gecos "" deploy
mkdir -p /var/www
chown deploy:deploy /var/www

以部署用户执行项目创建:

sudo -u deploy composer create-project \
  --no-interaction \
  "shopware/production:${SHOPWARE_VERSION}" \
  /var/www/shopware

如果 Shopware 项目已经通过代码仓库上传,则进入项目目录安装锁定依赖:

cd /var/www/shopware
sudo -u deploy composer install \
  --no-dev \
  --prefer-dist \
  --no-interaction \
  --optimize-autoloader

这一步可能消耗较多磁盘和内存。执行前确认:

df -h /var/www
free -h

如果 Composer 报 PHP 版本或扩展不满足,不要使用 --ignore-platform-reqs 绕过检查。应先确认 Shopware 版本与 PHP 版本是否匹配。

3. 写入 Shopware 环境变量

使用随机值生成应用密钥:

openssl rand -hex 32

创建 .env.local:

cd /var/www/shopware
umask 077

文件内容示例:

APP_ENV=prod
APP_URL=https://shop.example.jp
APP_SECRET=请替换为上面生成的随机字符串
DATABASE_URL="mysql://shopware:URL编码后的数据库密码@127.0.0.1:3306/shopware?charset=utf8mb4"

如果数据库密码包含 @、:、/、# 或空格,必须先进行 URL 编码,否则 Doctrine 可能把密码错误解析为主机、端口或参数。.env.local 包含数据库凭据,不应提交到 Git,也不应放在 Web 根目录可访问的位置。

设置文件权限:

chown www-www-data /var/www/shopware/.env.local
chmod 640 /var/www/shopware/.env.local

如果当前还没有 www-data 用户,说明 Nginx/PHP 包未正确安装,应先检查软件包,而不是手动创建同名系统账号。

4. 设置项目目录权限

Shopware 运行时需要写入缓存、日志、媒体和缩略图目录。初次安装可以将项目目录交给 PHP-FPM 用户:

chown -R www-www-data /var/www/shopware

该操作会改变整个项目目录的所有者,影响后续部署用户直接覆盖文件。执行前应确认代码已备份,并决定后续采用“部署用户发布文件”还是“PHP 用户拥有项目”的权限模型。

更细致的生产权限模型可以让代码归 deploy 用户所有,只给 www-data 写入运行时目录:

chown -R deploy:deploy /var/www/shopware
chown -R www-www-data \
  /var/www/shopware/var \
  /var/www/shopware/public/media \
  /var/www/shopware/public/thumbnail

如果目录不存在,应先核对当前 Shopware 版本的目录结构,不要直接创建一组与版本不匹配的路径。

五、配置 Nginx 和 HTTPS

1. 创建 Nginx 站点配置

新建配置文件:

cat > /etc/nginx/sites-available/shopware.conf <<'EOF'
server {
    listen 80;
    listen [::]:80;

    server_name shop.example.jp;

    root /var/www/shopware/public;
    index index.php;

    client_max_body_size 32m;

    location / {
        try_files $uri /index.php$is_args$args;
    }

    location ~ ^/index\.php(/|$) {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_read_timeout 120s;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ \.php$ {
        return 404;
    }

    location ~ /\.(?!well-known) {
        deny all;
    }
}
EOF

ln -s /etc/nginx/sites-available/shopware.conf \
  /etc/nginx/sites-enabled/shopware.conf

如果 Debian 默认站点占用了相同端口,可以先检查配置:

ls -l /etc/nginx/sites-enabled/
nginx -t

确认新站点正常后,再删除默认站点链接。删除操作只影响 Nginx 配置,不会删除 Shopware 文件,但仍应先保留配置备份:

cp -a /etc/nginx/sites-available/shopware.conf \
  /etc/nginx/sites-available/shopware.conf.bak

重新加载 Nginx:

systemctl reload nginx
systemctl enable nginx

reload 通常不会中断已有连接;如果配置错误,nginx -t 会在加载前给出提示,不能跳过检查直接重启。

2. 申请 TLS 证书

确认域名解析和 80 端口可达后安装 Certbot:

apt install -y certbot python3-certbot-nginx

申请证书并让 Certbot 修改 Nginx 配置:

certbot --nginx -d shop.example.jp

根据提示填写邮箱、同意条款,并选择 HTTP 自动跳转 HTTPS。申请完成后检查:

nginx -t
systemctl reload nginx
certbot certificates

验证 HTTPS:

curl -I https://shop.example.jp

如果证书申请失败,优先检查 DNS、云安全组、UFW、Nginx 是否监听 80 端口,以及 DNS 中是否存在指向其他服务器的 AAAA 记录。

六、完成 Shopware 安装和初始化

1. 使用 Web 安装器

浏览器访问:

https://shop.example.jp/recovery/install/index.php

安装器中填写:

  • 数据库主机:127.0.0.1
  • 数据库端口:3306
  • 数据库名称:shopware
  • 数据库用户:shopware
  • 数据库密码:前面创建的数据库密码
  • 店铺名称:实际店铺名称
  • 管理员邮箱:实际运维邮箱
  • 管理员密码:独立、高强度,不与服务器密码重复
  • 店铺语言:根据实际销售地区选择
  • 店铺货币:日本市场通常需要配置 JPY,但最终应以业务结算要求为准
  • 国家和税率:根据实际经营主体、商品类型和税务规则配置

日本服务器只决定服务器所在位置,不会自动把 Shopware 设置为日文、日元或日本税率。语言、货币、销售渠道域名和税率需要在安装器或后台中分别确认。

安装完成后访问:

https://shop.example.jp/admin

如果需要命令行操作,先查看当前版本支持的安装参数:

cd /var/www/shopware
sudo -u www-data php bin/console system:install --help

不同 Shopware 小版本的命令参数可能不同,不能照抄其他版本的安装命令。

2. 清理缓存并检查应用状态

安装完成后执行:

cd /var/www/shopware
sudo -u www-data php bin/console cache:clear --env=prod
sudo -u www-data php bin/console about

如果版本提供系统检查命令,可先查看命令列表:

sudo -u www-data php bin/console list | grep -E 'system|scheduled|messenger'

不要因为某篇教程中存在某个命令,就假设当前版本一定支持。以当前项目的 bin/console list 输出为准。

3. 配置计划任务和异步任务

Shopware 的计划任务用于处理清理、索引、邮件和其他后台工作。先确认命令存在:

cd /var/www/shopware
sudo -u www-data php bin/console list | grep scheduled

如果存在 scheduled-task:run,可以创建 Cron:

cat > /etc/cron.d/shopware <<'EOF'
*/5 * * * * www-data cd /var/www/shopware && /usr/bin/php bin/console scheduled-task:run --no-interaction >> /var/log/shopware-scheduled.log 2>&1
EOF

chmod 644 /etc/cron.d/shopware

异步消息消费者只应在项目已经配置 async 传输时启用。先检查项目命令和环境配置,再创建 systemd 服务:

cat > /etc/systemd/system/shopware-worker.service <<'EOF'
[Unit]
Description=Shopware async message worker
After=network.target mariadb.service php8.2-fpm.service

[Service]
Type=simple
User=www-data
WorkingDirectory=/var/www/shopware
ExecStart=/usr/bin/php /var/www/shopware/bin/console messenger:consume async --time-limit=300 --memory-limit=512M
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

启用前检查命令是否存在,并确认后台确实使用了 async 传输:

cd /var/www/shopware
sudo -u www-data php bin/console list | grep messenger

确认无误后:

systemctl daemon-reload
systemctl enable --now shopware-worker
systemctl status shopware-worker --no-pager

如果没有配置异步队列,不要盲目启动消费者。错误的消费者配置可能持续产生重试日志和无效进程。

七、上线结果验证

1. 基础服务验证

systemctl is-active nginx
systemctl is-active php8.2-fpm
systemctl is-active mariadb

预期结果均为:

active

检查 PHP-FPM 套接字:

ls -l /run/php/php8.2-fpm.sock

检查 Nginx 监听端口:

ss -lntp | grep -E ':80|:443'

检查磁盘和内存:

df -h
free -h

如果根分区可用空间低于约 20%,不宜继续进行大规模商品导入或图片处理,应先清理日志、扩展磁盘或调整存储方案。

2. HTTP、HTTPS 和应用验证

检查首页响应:

curl -I https://shop.example.jp/

检查后台入口:

curl -I https://shop.example.jp/admin

也可以记录首字节时间,用于后续对比,不把一次命令结果当成固定性能结论:

curl -sS -o /dev/null \
  -w 'HTTP %{http_code}\nDNS %{time_namelookup}s\nTTFB %{time_starttransfer}s\nTOTAL %{time_total}s\n' \
  https://shop.example.jp/

浏览器中至少完成以下操作:

七、上线结果验证配图

  1. 打开店铺首页,确认没有 502、500 或循环跳转。
  2. 登录 /admin,确认后台资源可以加载。
  3. 创建一个测试商品并发布到正确销售渠道。
  4. 使用前台浏览商品、加入购物车并进入结算流程。
  5. 上传一张测试图片,确认媒体文件和缩略图可以访问。
  6. 检查浏览器开发者工具中是否出现混合内容、跨域或静态资源 404。
  7. 清理测试订单、测试客户和测试商品,避免进入正式数据。

3. 日志验证

Nginx 错误日志:

tail -n 100 /var/log/nginx/error.log

PHP-FPM 日志:

journalctl -u php8.2-fpm -n 100 --no-pager

MariaDB 日志:

journalctl -u mariadb -n 100 --no-pager

Shopware 应用日志通常位于:

/var/www/shopware/var/log/

检查最近的 PHP 致命错误、数据库连接错误、权限错误和队列重试信息。上线后应配置日志轮转,避免单个日志文件占满磁盘。

八、常见失败处理

1. 页面返回 502 Bad Gateway

按由外到内的顺序检查:

systemctl status php8.2-fpm --no-pager
ls -l /run/php/php8.2-fpm.sock
nginx -t
tail -n 100 /var/log/nginx/error.log

常见原因包括:

  • Nginx 配置的 PHP-FPM 套接字与实际版本不一致。
  • PHP-FPM 没有启动。
  • PHP-FPM 进程因内存不足被终止。
  • 配置文件语法错误。
  • PHP-FPM 用户无法读取项目文件。

如果套接字实际是 /run/php/php8.2-fpm.sock,Nginx 中就不能写成其他 PHP 版本路径。

2. 页面返回 500 或显示空白

查看 Shopware 日志和 PHP-FPM 日志:

tail -n 100 /var/www/shopware/var/log/*.log
journalctl -u php8.2-fpm -n 100 --no-pager

重点检查:

  • APP_SECRET 是否存在。
  • DATABASE_URL 是否写错或未进行 URL 编码。
  • PHP 扩展是否缺失。
  • memory_limit 是否过低。
  • var/cache 和 var/log 是否可写。
  • 部署新代码后是否重启了 PHP-FPM。

清理缓存前应确认当前代码和数据库版本匹配:

cd /var/www/shopware
sudo -u www-data php bin/console cache:clear --env=prod
systemctl restart php8.2-fpm

重启会清空现有 PHP-FPM 工作进程,适合在维护窗口执行。

3. 安装器无法连接数据库

先单独测试数据库:

mariadb \
  --host=127.0.0.1 \
  --user=shopware \
  --password \
  --database=shopware \
  --execute="SELECT 1;"

如果命令失败,分别检查:

  • MariaDB 是否运行。
  • 数据库名和账号是否拼写正确。
  • 账号是否授权给 127.0.0.1,而不是只授权给 localhost。
  • 数据库密码中的特殊字符是否完成 URL 编码。
  • Shopware 使用的主机是否为 127.0.0.1,不要在 localhost、Unix Socket 和 TCP 之间混用而不核对。

不要为了临时安装把数据库开放到公网,也不要给 Shopware 使用 MariaDB root 账号。

4. 静态文件、图片或路由返回 404

首先确认 Nginx 根目录是:

/var/www/shopware/public

而不是:

/var/www/shopware

再检查文件和目录权限:

namei -l /var/www/shopware/public
find /var/www/shopware/public -maxdepth 2 -type d -name media -o -name thumbnail

如果只有部分路由 404,检查 try_files 配置和 Nginx 是否已重新加载。若图片上传成功但前台无法读取,检查 public/media 的所有者和文件权限。

5. HTTPS 证书申请失败

检查:

dig +short A shop.example.jp
dig +short AAAA shop.example.jp
ss -lntp | grep ':80'
curl -I http://shop.example.jp/

常见原因是域名没有指向当前日本服务器、AAAA 记录指向旧服务器、云安全组未放行 80 端口,或 Nginx 的 server_name 不匹配。证书申请失败时,不要反复执行命令覆盖现有 Nginx 配置,应先修复解析和网络路径。

6. 计划任务没有执行

检查 Cron 文件权限和日志:

ls -l /etc/cron.d/shopware
tail -n 100 /var/log/shopware-scheduled.log

手动执行一次:

cd /var/www/shopware
sudo -u www-data php bin/console scheduled-task:run --no-interaction

如果没有该命令,应以 php bin/console list 为准查找当前版本的计划任务实现。异步任务积压时,检查消费者:

systemctl status shopware-worker --no-pager
journalctl -u shopware-worker -n 100 --no-pager

九、备份与回滚方案

1. 上线前建立可恢复备份

数据库备份示例:

mkdir -p /var/backups/shopware
chmod 700 /var/backups/shopware

mariadb-dump \
  --host=127.0.0.1 \
  --user=shopware \
  --password \
  --single-transaction \
  --routines \
  --events \
  --hex-blob \
  shopware | gzip > /var/backups/shopware/shopware-$(date +%F-%H%M).sql.gz

备份应用配置和媒体文件:

tar -C /var/www/shopware -czf \
  /var/backups/shopware/shopware-files-$(date +%F-%H%M).tar.gz \
  .env.local composer.json composer.lock public/media public/thumbnail

数据库备份和文件备份应复制到另一台存储或对象存储。仅保存在当前服务器上,无法覆盖磁盘损坏、误删服务器或账号被破坏等场景。

2. 代码更新的安全方式

上线更新前至少保存:

  • 当前运行版本的 composer.lock。
  • .env.local。
  • 数据库备份。
  • public/media 和 public/thumbnail。
  • 当前 Nginx 配置。
  • 当前 Shopware 版本和插件列表。

更稳妥的结构是采用版本目录:

/var/www/releases/20250101-1200/
/var/www/releases/20250115-0930/
/var/www/current -> /var/www/releases/20250115-0930

Nginx 的根目录指向 /var/www/current/public。新版本完成 Composer 安装、配置检查和缓存预热后,再切换 current 符号链接并重载服务。这样可以保留上一个代码版本,减少直接覆盖线上目录带来的风险。

3. 发生故障时的回滚边界

如果只是 PHP 代码或插件文件错误,可以按以下顺序处理:

  1. 暂停发布和异步任务,避免新请求继续写入异常代码。
  2. 保留当前日志和错误现场,不要先删除缓存与日志。
  3. 将 Nginx 根目录切换回上一份代码。
  4. 清理旧版本生成的应用缓存。
  5. 重启 PHP-FPM,使 OPcache 加载旧版本代码。
  6. 验证首页、后台、购物车和订单查询。

如果新版本已经执行数据库结构迁移,不能只回滚代码。数据库向前迁移后,旧代码可能无法识别新字段或新数据。此时需要根据发布记录判断:

九、备份与回滚方案配图

  • 有明确向后兼容的迁移:保留数据库,先回滚代码并验证。
  • 存在破坏性结构变化或数据格式变化:进入维护状态,使用上线前数据库备份恢复,再切换旧代码。
  • 订单、客户或库存已经产生新数据:恢复数据库会丢失备份之后的数据,必须先评估并导出新增业务数据。

数据库恢复属于高影响操作,执行前要停止写入、确认备份文件完整,并记录当前数据库快照。不能把“恢复数据库”当作普通清缓存操作。

十、上线验收清单

上线前可以按以下清单逐项确认:

  • [ ] 服务器系统版本、PHP 版本和 Shopware 小版本已经固定。
  • [ ] PHP 扩展满足目标 Shopware 要求,没有使用 --ignore-platform-reqs。
  • [ ] composer.lock 已保存,生产依赖使用 --no-dev 安装。
  • [ ] 域名 A/AAAA 记录只指向实际可用的网络入口。
  • [ ] 80 和 443 端口可访问,SSH 和数据库没有暴露不必要的公网端口。
  • [ ] Nginx 根目录指向 /var/www/shopware/public。
  • [ ] PHP-FPM 套接字路径与 Nginx 配置一致。
  • [ ] MariaDB 使用独立数据库和专用账号,未使用 root 连接 Shopware。
  • [ ] .env.local 权限受限,数据库密码未进入代码仓库。
  • [ ] HTTPS 证书有效,HTTP 到 HTTPS 的跳转符合预期。
  • [ ] 店铺首页、后台、商品详情、购物车和结算页均可访问。
  • [ ] 测试商品、媒体文件和缩略图能够正常显示。
  • [ ] 语言、JPY 或其他币种、销售渠道域名和税率已经按业务要求确认。
  • [ ] 计划任务可以执行,异步任务配置与消费者状态正常。
  • [ ] 数据库、配置、媒体文件和当前代码均有备份。
  • [ ] 已验证至少一次数据库备份的可读取性。
  • [ ] 已记录上一版本代码、Nginx 配置和回滚负责人。
  • [ ] 已设置磁盘、内存、PHP-FPM、MariaDB、Nginx 和 Shopware 错误日志监控。

完成这些检查后,再开放正式支付、邮件和物流配置,并删除测试订单与测试账号。日本服务器的位置、Shopware 的应用配置和线上运维流程应分别验收,不能用“服务器在日本”替代对域名、语言、币种、税率、性能和数据恢复能力的检查。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3761.html

相关推荐