部署与基础设施 on 远栈

Sub2API 部署教程：在 Ubuntu 24.04 上配置 HTTPS、AI 账号和 API Key

Tue, 15 Sep 2026 00:20:00 +0800

如果你已经有 Claude、OpenAI 或 Gemini 账号，想在 Codex、Cherry Studio 等客户端里使用，可以在自己的 Ubuntu 服务器上部署 Sub2API。账号保存在网关后台，客户端只填写网关地址和单独生成的 API Key，不需要拿到原账号的登录信息。

发布失败怎么自动恢复原版本：事务状态、入口切换与回滚边界

Thu, 03 Sep 2026 02:30:00 +0800

发布脚本突然退出时，不要直接执行 docker compose down。恢复动作取决于三个事实：候选版本是否已经接管公开流量、旧入口是否还能恢复、业务验证是否完成。旧版本仍在服务时，只需清理候选；入口可能切到一半时，要恢复旧上游；新版本仍在观察时，也应切回旧版；只有发布已经进入提交阶段，恢复程序才继续补齐提交记录。

Docker Compose 单机短停机发布：健康检查、入口切换与连接排空

Thu, 03 Sep 2026 02:25:00 +0800

单机短停机发布的可靠顺序是：启动候选版本，等待业务就绪，校验并切换 Caddy 上游，从公开域名确认结果，排空旧连接，最后停止旧版本。旧容器不能在候选版本接管流量前删除。

入口切换是唯一对外生效点；候选启动和预热都发生在切换之前。

适用条件与限制

同一台主机同时运行蓝、绿两套应用实例，适合满足以下条件的服务：

数据库迁移应该在发布哪一步执行：Expand、Migrate、Contract

Thu, 03 Sep 2026 02:20:00 +0800

数据库迁移没有统一的“先于应用”或“晚于应用”答案。安全顺序取决于新旧应用能否同时使用当前 schema：新增兼容结构先执行，应用再上线，数据随后回填；删除字段、改名和收紧约束放到旧版本退出后的独立发布。

Docker 镜像为什么要固定 digest：可复现部署、升级与回滚

Thu, 03 Sep 2026 02:15:00 +0800

生产镜像应写成 仓库:版本@sha256:摘要。版本 tag 让人看懂计划部署哪个版本，digest 让 Docker 拉取确定的内容；仅使用 latest、stable 或可移动版本 tag，无法保证重建和回滚得到原来的镜像。

OneDev 完整教程：从 Docker 部署、Git 仓库到 CI/CD 自动发布

Thu, 03 Sep 2026 02:10:00 +0800

OneDev 可以在一个实例里管理 Git 仓库、代码评审、Issue、CI/CD、构建制品和软件包。需要把代码留在自有服务器，又不想分别维护 Git 服务、CI 和包仓库时，可以考虑使用 OneDev。它的单机资源要求也低于完整 GitLab。

Docker 数据卷、文件权限与密钥怎么配置

Thu, 03 Sep 2026 00:00:00 +0800

数据库和应用状态写入 volume，只读配置使用 bind mount，密钥通过文件挂载给指定服务。配置完成后还要核对进程 UID/GID，并分别执行容器重建和独立恢复。

数据库写入 named volume，配置只读挂载，密钥仅挂载到需要它的服务。

根据数据用途选择 named volume、bind mount 或 tmpfs

类型	适合内容	优点	主要风险
named volume	数据库、队列、应用持久状态	生命周期由 Docker 管理，路径不与单台主机布局强耦合	宿主备份和迁移要明确卷名与驱动
bind mount	Caddyfile、明确的数据目录、宿主脚本	路径可见，便于现有备份与权限工具管理	强依赖宿主路径、属主和 SELinux/AppArmor 条件
tmpfs	临时敏感文件、无需持久化的高速临时数据	不写入持久磁盘	重启即丢失，容量占用内存

Docker storage 文档（在新标签页打开）建议优先用 volume 保存容器生成的持久数据；bind mount 更适合需要直接共享和管理的宿主文件。镜像层不适合承载运行数据，容器删除时可写层也会消失。

Docker 端口怎么暴露：127.0.0.1、0.0.0.0、防火墙与容器网络

Wed, 02 Sep 2026 23:50:00 +0800

判断 Docker 端口是否暴露，需要分别查看容器内监听地址、宿主机端口绑定，以及防火墙和云安全组。容器内监听 0.0.0.0，不等于该端口已经暴露到公网。

应用和数据库只在 Docker 网络通信；公网只能到达反向代理开放的端口。

监听地址、宿主绑定和服务名属于不同网络层

配置位置	示例	含义
应用进程监听	`0.0.0.0:8080`	接受当前容器所有网络接口上的 8080 连接
应用进程监听	`127.0.0.1:8080`	只接受同一容器回环接口的连接
Docker 端口发布	`127.0.0.1:8080:8080`	宿主机本地可通过 8080 访问容器 8080
Docker 端口发布	`0.0.0.0:8080:8080`	宿主机全部 IPv4 接口发布 8080，可能被公网访问
Compose 内部访问	`http://app:8080`	同网络服务通过服务名访问容器端口

两处 0.0.0.0 的作用不同。应用在容器内监听全部接口，是为了让同网络代理访问；Docker 把端口发布到宿主全部接口，则扩大了宿主机入口。

502 和 504 怎么排查：反向代理、Docker 网络与上游超时

Wed, 02 Sep 2026 23:40:00 +0800

502 和 504 都由网关或反向代理返回，但含义不同：502 表示代理没有从上游得到可用响应，504 表示代理等待上游响应超过时限。排查时先找到产生状态码的那一层，再从该层所在的网络访问上游。

连接拒绝、解析失败和无效响应通常指向 502；上游等待超过代理期限通常指向 504。

确认哪一层返回 502 或 504

浏览器前面可能同时有 CDN、云负载均衡、Caddy 或 Nginx。先保留状态码、响应头、时间和请求 ID：

Caddy、Nginx、Nginx Proxy Manager 怎么选：反向代理与 HTTPS 对比

Wed, 02 Sep 2026 10:30:00 +0800

少量站点、希望配置进入 Git 并自动处理 HTTPS，可以先选 Caddy；已有大量 Nginx 配置或需要细粒度模块能力，继续用 Nginx；更习惯图形界面、管理的站点也不多，再考虑 Nginx Proxy Manager。

先选维护方式，再看现有资产。大多数小型新站点不需要从性能跑分开始选。

配置方式和维护对象

维度	Caddy	Nginx	Nginx Proxy Manager
日常配置	Caddyfile 或 JSON	Nginx 配置文件	Web 管理界面
HTTPS	自动签发和续期是默认能力	通常搭配 Certbot、acme.sh 或云证书	界面集成常见证书操作
Git 管理	很适合	很适合	主要状态在数据库中
WebSocket	常见场景自动处理	需要正确设置升级相关头	由生成的 Nginx 配置处理
缓存和限流	可以配置	能力成熟、控制细	受界面与高级配置范围影响
额外状态	配置和证书目录	配置、证书和相关脚本	应用、数据库、证书和生成配置

三者都能完成常见的 HTTPS 入口和反向代理。文件配置便于审查和回滚；数据库配置便于界面操作，但备份必须同时覆盖数据库和证书。

Docker Compose 生产部署指南：镜像、健康检查、密钥与持久化

Wed, 02 Sep 2026 10:00:00 +0800

docker compose up -d 只能说明容器已经启动。生产部署还要固定镜像、保存数据、隔离端口、限制资源，并验证容器和主机重启后的恢复结果。

公网只开放反向代理的 80/443；应用端口留在回环地址或容器网络中。

Compose 适合什么样的生产服务

单台主机、服务数量不多、依赖关系清楚时，Compose 足以承担部署：

Nginx Proxy Manager部署指南 | 可视化管理Nginx反向代理和SSL证书

Fri, 11 Oct 2024 00:00:32 +0800

自建Nginx Proxy Manager（在新标签页打开）

前置条件：在服务器安装完成Docker

部署NPM

sudo -i
mkdir -p /root/data/docker_data/npm

编辑docker-compose.yml文件

cd /root/data/docker_data/npm

vim docker-compose.yml

# 输入安装脚本
version: '3'
services:
 app:
 image: 'jc21/nginx-proxy-manager:latest'
 restart: unless-stopped
 ports:
 - '80:80' # 保持默认即可，不建议修改左侧的80
 - '81:81' # 冒号左边可以改成自己服务器未被占用的端口
 - '443:443' # 保持默认即可，不建议修改左侧的443
 volumes:
 - ./data:/data # 冒号左边可以改路径，现在是表示把数据存放在在当前文件夹下的 data 文件夹中
 - ./letsencrypt:/etc/letsencrypt # 冒号左边可以改路径，现在是表示把数据存放在在当前文件夹下的 letsencrypt 文件夹中

安装NPM

cd /root/data/docker_data/npm
docker compose up -d

输入 http://ip:81（在新标签页打开）访问

默认登陆名和密码：

Email: admin@example.com
Password: changeme

更新 Nginx Proxy Manager

cd /root/data/docker_data/npm

docker compose down

cp -r /root/data/docker_data/npm /root/data/docker_data/npm.archive #备份一份数据

docker compose pull

docker compose up -d

docker image prune # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

卸载 Nginx Proxy Manager

cd /root/data/docker_data/npm

docker compose down

rm -rf /root/data/docker_data/npm