美国洛杉矶服务器用Docker Compose部署服务,如何配置持久化与开机启动
本文以一台运行 Ubuntu 22.04 或 24.04 的美国洛杉矶 Linux 服务器为例,部署一个 PostgreSQL 服务,并通过 Docker Compose 配置数据持久化和主机开机后的自动启动。实现这两个目标需要分别处理:数据库数据写入 Docker 命名卷,Docker 服务设置为随系统启动,容器配置 restart 策略。
开始前应已能通过 SSH 登录服务器,并拥有 sudo 权限。还需确认系统盘有足够空间、服务器时间正常;如果服务只供同机应用使用,不必将数据库端口开放到公网。下面的命令以 Ubuntu 为准,Debian 等系统的 Docker 软件源配置不同,不要直接套用。
一、确认系统与部署目录
先检查发行版和架构:
cat /etc/os-release
uname -m
以下步骤适用于 Ubuntu 22.04 或 24.04。若系统版本不符,应先按对应发行版的 Docker Engine 安装文档调整软件源步骤。
创建专用目录,集中存放 Compose 配置和环境变量文件:
sudo mkdir -p /opt/compose-db
sudo chown "$USER":"$(id -gn)" /opt/compose-db
cd /opt/compose-db
这个目录只保存部署配置;数据库实际文件会存放在 Docker 命名卷中,不应误把它当成数据库数据目录。
二、安装 Docker Engine 和 Compose 插件
如果服务器已经安装 Docker Engine,可先检查版本并跳到“启动 Docker 服务”:
docker --version
docker compose version
若提示命令不存在,可在 Ubuntu 上添加 Docker 官方软件源并安装 Engine 与 Compose 插件:
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
安装完成后检查命令版本:
sudo docker --version
sudo docker compose version
预期能看到 Docker Engine 和 Compose 插件的版本信息。生产环境应在升级前阅读新版本说明,并避免在业务高峰期直接升级 Docker 或数据库主版本。
三、配置 Docker 随系统启动
容器的重启策略依赖 Docker 服务正常运行,因此需要将 Docker 设置为开机启动,并立即启动服务:
sudo systemctl enable --now docker
sudo systemctl is-enabled docker
sudo systemctl is-active docker
正常情况下,前两条检查分别返回 enabled 和 active。若 systemctl 报错,先确认系统是否使用 systemd;非 systemd 环境需要按其服务管理方式设置开机启动。
本例继续使用 sudo docker 执行命令。将用户加入 docker 组虽然可以免去 sudo,但该组权限很高,通常相当于拥有主机 root 级别的控制能力,不应为了方便在多人共用的服务器上随意添加成员。
四、创建数据库配置与 Compose 文件
1. 设置数据库环境变量
生成一段随机密码:
openssl rand -hex 24
将输出的字符串填入下方 POSTGRES_PASSWORD。示例中的占位密码不能直接用于正式环境:
cd /opt/compose-db
umask 077
cat > .env <<'EOF'
POSTGRES_DB=appdb
POSTGRES_USER=appuser
POSTGRES_PASSWORD=请替换为随机生成的密码
EOF
chmod 600 .env
检查文件权限和内容:
ls -l .env
cat .env
.env 应仅允许文件所有者读取和修改。实际部署时,不要将包含密码的文件提交到代码仓库,也不要把密码直接写入公开工单、命令记录或网页文档。若服务器由多人管理,还应结合访问控制和备份权限管理秘密信息。
2. 编写 Compose 配置
创建 compose.yaml:
cat > compose.yaml <<'EOF'
services:
db:
image: postgres:16-alpine
container_name: compose-db
restart: unless-stopped
env_file:
- .env
ports:
- "127.0.0.1:5432:5432"
volumes:
- pg/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""]
interval: 10s
timeout: 5s
retries: 5
start_period: 20s
volumes:
pg
EOF
配置中有三项与本次目标直接相关:

pg/var/lib/postgresql/data将 PostgreSQL 数据目录挂载到 Docker 命名卷。删除并重建容器时,只要不删除该卷,数据库文件仍会保留。restart: unless-stopped让容器在 Docker 服务启动后自动恢复运行;如果管理员明确手动停止容器,它不会因 Docker 重启而自行恢复。"127.0.0.1:5432:5432"只将数据库端口绑定到服务器本机回环地址,避免通过该端口直接接受公网连接。同机应用应通过 Compose 网络中的服务名db访问数据库,连接端口为5432。
postgres:16-alpine 是示例镜像标签。正式上线前应确认应用兼容的 PostgreSQL 版本,并通过测试环境验证升级方案。不要仅为更新镜像就随意切换数据库主版本。
3. 检查配置并启动服务
先让 Compose 检查配置是否能解析:
sudo docker compose config
若输出中包含服务 db、命名卷 pgdata 和预期端口映射,说明配置已被读取。输出可能包含展开后的环境变量,分享日志前应检查并遮盖敏感信息。
启动数据库:
sudo docker compose up -d
查看容器状态:
sudo docker compose ps
启动完成后,状态通常为 Up,健康检查状态可能显示为 healthy。首次启动时镜像下载和数据库初始化需要时间;在健康检查完成前,短暂显示 starting 不一定代表故障。
五、验证持久化与自动启动
1. 验证数据库可用
先检查健康状态:
sudo docker inspect --format='{{.State.Status}} {{if .State.Health}}{{.State.Health.Status}}{{end}}' compose-db
期望结果类似:
running healthy
也可使用 PostgreSQL 自带的连接检查命令:
sudo docker compose exec db sh -c \
'pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"'
正常时会返回服务器正在接受连接的提示。如果需要确认数据库身份和版本,可执行:
sudo docker compose exec db sh -c \
'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c "SELECT current_database(), version();"'
2. 验证容器重启后数据保留
创建一张用于验收的测试表并写入一行数据:
sudo docker compose exec -T db sh -c \
'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB"' <<'SQL'
CREATE TABLE IF NOT EXISTS persistence_check (
id integer PRIMARY KEY,
note text NOT NULL
);
INSERT INTO persistence_check (id, note)
VALUES (1, 'volume-check')
ON CONFLICT (id) DO UPDATE SET note = EXCLUDED.note;
SQL
重启容器:
sudo docker compose restart db
sudo docker compose ps
等待服务健康后查询:
sudo docker compose exec db sh -c \
'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c "SELECT * FROM persistence_check;"'
若仍能读到 volume-check,说明数据在容器重启后保留。也可确认 Compose 项目关联的命名卷:
sudo docker volume ls
sudo docker volume inspect compose-db_pgdata
卷名通常会带有项目目录名作为前缀;如果启动时使用了不同项目名,实际名称可能不同,应以 docker volume ls 的结果为准。
3. 验证主机重启后自动启动
先确认 Docker 服务和容器重启策略:
sudo systemctl is-enabled docker
sudo docker inspect --format='{{.HostConfig.RestartPolicy.Name}}' compose-db
本例预期分别为 enabled 和 unless-stopped。如需验证实际开机流程,可选择维护窗口重启服务器;重启会中断该主机上的其他服务,执行前应确认业务影响,并确保 SSH 等管理方式可恢复:
sudo reboot
重新登录后检查:
sudo systemctl is-active docker
sudo docker compose -f /opt/compose-db/compose.yaml ps
如果容器显示运行中且健康检查通过,即可确认 Docker 随系统启动,容器也按重启策略恢复运行。对于通过 Compose 启动的项目,不一定要另写一套 systemd 单元;Docker 的开机服务和容器重启策略已覆盖本例需求。需要额外执行启动前检查、特殊挂载或严格依赖顺序时,再评估是否编写 systemd 单元。
六、常见异常及处理
Docker 命令提示权限不足
如果执行 docker compose 时出现无法连接 Docker socket 或权限拒绝,先用 sudo 重试,并检查服务状态:
sudo systemctl status docker --no-pager
sudo docker info
若 Docker 服务未运行,查看状态输出和日志:
sudo journalctl -u docker -n 100 --no-pager
不要通过对 Docker socket 设置全局可写权限来绕过问题,这会扩大主机风险。
容器反复退出或健康检查失败
先查看 Compose 状态和数据库日志:
sudo docker compose ps
sudo docker compose logs --tail=100 db
常见原因包括环境变量写错、主机磁盘空间不足、已有进程占用端口,或数据库数据目录存在不兼容的旧数据。检查磁盘和端口监听情况:
df -h
sudo ss -lntp | grep ':5432'
日志中出现认证失败时,检查 .env 中的数据库名称、用户名及密码是否符合预期。需要注意:PostgreSQL 初始化环境变量主要在数据目录为空时生效;如果命名卷里已有数据库,修改 .env 中的 POSTGRES_PASSWORD 不会自动修改已初始化数据库中的用户密码。应使用数据库管理操作调整密码,而不是删除数据卷。
若 5432 已被主机上的其他程序占用,可将左侧主机端口改为其他未占用端口,例如 "127.0.0.1:15432:5432",然后重新应用配置:
sudo docker compose up -d
这只改变主机侧端口;容器间访问仍使用 db:5432。如果本服务不需要从主机外部访问,不要为了消除连接问题而绑定到 0.0.0.0 或向公网开放数据库端口。
配置修改后数据似乎消失
先不要删除卷,也不要执行带 -v 的停止命令。确认 Compose 项目名、工作目录和卷名是否与初次启动时一致:
cd /opt/compose-db
sudo docker compose ps -a
sudo docker volume ls
sudo docker compose config
不同目录或不同 -p 项目名可能创建不同前缀的命名卷,导致新容器看起来像是空数据库。找到原卷前不要继续写入重要数据,以免新旧数据库混用。
Docker Compose 的命名卷能保留容器重建时的数据,而数据库文件仍依赖服务器本地磁盘。A5idc数据提供美国洛杉矶等地区的物理服务器,涵盖 Xeon 与 AMD EPYC 等平台,并有搭配 NVMe 存储的方案,可为面向美国用户的数据库、容器服务和业务后台提供计算与存储资源基础。不同配置覆盖不同的处理器、内存和磁盘组合,便于承载从常规业务到多任务运行的部署场景。
七、备份与回滚
命名卷可以避免容器重建时丢失数据,但不等于备份。卷仍依赖当前服务器及其磁盘;硬件故障、误删卷或主机损坏都可能造成数据不可用。正式承载数据前,应另行制定备份保存位置、保留期限和恢复演练方式。
可先生成逻辑备份文件:
cd /opt/compose-db
sudo docker compose exec -T db sh -c \
'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
> /opt/compose-db/appdb-backup.dump
检查文件是否生成且非空:
sudo test -s /opt/compose-db/appdb-backup.dump \
&& sudo ls -lh /opt/compose-db/appdb-backup.dump
该文件仍位于同一台服务器,不足以应对整机损坏;应根据业务要求复制到受控的异地或独立存储,并限制备份文件访问权限。恢复前应先确认目标数据库版本兼容、目标环境为空或已有明确的覆盖方案。
若新配置无法启动,可先保存当前配置,再恢复上一份经过验证的 compose.yaml,然后重新应用:
cd /opt/compose-db
cp compose.yaml compose.yaml.failed
# 将上一份已验证的 compose.yaml 恢复到当前目录
sudo docker compose up -d
sudo docker compose ps
如需停止本项目但保留数据库卷,可执行:
sudo docker compose down
该命令会停止并移除容器和网络,但默认保留命名卷。切勿在未完成备份和确认影响范围前执行 docker compose down -v:-v 会删除 Compose 管理的命名卷,可能导致数据库数据丢失。确需删除卷时,应先核对卷名、确认备份可恢复,并明确接受数据删除影响。
上线验收清单
docker compose config能正常解析,.env权限受到限制,密码未提交到代码仓库。- Docker 服务显示为
enabled和active,容器重启策略符合预期。 - 数据库容器显示运行且健康检查通过,数据库端口只绑定到预期地址。
- 写入测试记录后重启容器,记录仍可查询。
- 维护窗口内完成主机重启验证,Docker 和数据库容器均能自动恢复。
- 已生成数据库备份,并确认其存放位置、访问权限和恢复责任人。
- 配置回滚路径清楚;停止项目时不会误删命名卷,未经备份和确认不执行
down -v。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8245.html



