如何在美国服务器上配置Traefik网关,为网站提供HTTPS入口?
在美国服务器上为网站配置 HTTPS 入口,核心不是为美国地区单独设置一套 TLS 参数,而是让域名正确解析到服务器、确保 TCP 80/443 端口可达,再由 Traefik 监听入口、申请证书并把请求转发到后端网站。下面以 Ubuntu 22.04/24.04 LTS、Docker Compose、单个网站域名 app.example.com 为例,完成 Traefik 的首次部署与验证。

部署完成后,用户访问 http://app.example.com 会被重定向到 HTTPS,Traefik 在 443 端口终止 TLS 连接,并根据域名将请求转发到同一台美国服务器上的网站容器。文中的 app.example.com、邮箱和镜像地址都是示例,执行前需要替换成实际值。
A5idc数据提供美国物理服务器,涵盖常规 Xeon、AMD EPYC 及多 IP 等产品,并有 CN2 GIA 线路方案。不同处理器、内存与 NVMe 存储配置,可为部署 Traefik 网关的网站、容器化应用和业务接口提供计算与存储资源基础,也适用于面向美国用户的网站及跨境业务。
目标拓扑与实施边界
本次部署采用 Traefik 作为公网入口,测试后端使用 whoami 容器验证路由是否正常。实际网站上线时,只需要把测试容器替换成现有网站服务,不需要把网站容器的端口直接暴露到公网。
浏览器
│
├─ TCP 80 ──> Traefik ──> HTTP 301/308 跳转到 HTTPS
│
└─ TCP 443 ──> Traefik ──> TLS 终止
│
└─ Host(app.example.com)
│
└─ Docker 网络 web
│
└─ 网站容器
Traefik 使用 ACME HTTP-01 方式申请证书。申请和后续续期都需要公网能够访问服务器的 80 端口,因此不能因为网站强制 HTTPS 就关闭 80 端口。
| 项目 | 示例要求 | 验证方式 |
|---|---|---|
| 操作系统 | Ubuntu 22.04 或 24.04 LTS | cat /etc/os-release |
| 服务器网络 | 公网 IPv4;IPv6 可选 | 查看服务商控制台和 ip addr |
| 域名 | app.example.com | dig A/AAAA |
| 云防火墙 | 放行 TCP 80、443 | 服务商安全组或网络 ACL |
| 系统防火墙 | 放行 TCP 80、443 | ufw status verbose |
| 容器运行环境 | Docker Engine 与 Compose v2 | docker version、docker compose version |
| 后端网站 | 能在 Docker 网络中监听容器端口 | 容器日志和内部连通性 |
| ACME 邮箱 | 可接收证书相关通知 | .env 配置 |
美国服务器所在地区不会改变 Traefik 的路由规则,但公网 IP、云安全组、DNS 解析和 IPv6 配置必须保持一致。
准备条件
核对域名解析
在域名管理平台创建一条 A 记录,将网站域名指向美国服务器的公网 IPv4。服务器启用了 IPv6 时,再确认 AAAA 记录是否指向同一台服务器。
dig +short A app.example.com
dig +short AAAA app.example.com
预期结果是:
- A 记录返回美国服务器的公网 IPv4;
- 如果存在 AAAA 记录,返回的 IPv6 也必须能够到达同一台服务器;
- 如果 AAAA 指向旧服务器或没有配置 IPv6 路由,应修正或删除该记录。
不要只在服务器本机测试 DNS。可以从个人电脑、办公网络或其他外部网络分别执行相同查询,避免本地 DNS 缓存导致误判。
如果系统没有 dig,可以安装 DNS 查询工具:
sudo apt-get update
sudo apt-get install -y dnsutils
检查 80 和 443 端口
Traefik 需要绑定宿主机的 80 和 443 端口。先查看是否已经有其他服务占用:
sudo ss -ltnp | grep -E ':(80|443)\b' || true
没有输出通常表示端口空闲。如果输出中出现已有 Web 服务,需要先确认它的用途、配置文件和回滚方式,不能直接停止未知服务。
可以进一步查看常见服务状态:
sudo systemctl --type=service --state=running | grep -E 'nginx|apache2|caddy' || true
如果 80 或 443 已经由现有反向代理使用,有两种处理思路:
- 将 Traefik 纳入现有入口架构,由现有服务继续监听公网端口;
- 在维护窗口内备份现有配置,再将 80/443 交给 Traefik。
本文采用第二种方式中的“端口空闲”场景。停止已有服务会造成网站中断,且可能影响同一服务器上的其他域名,应先完成配置备份。
放行云防火墙和系统防火墙
除了服务器内部的 UFW,很多美国云服务器还存在服务商安全组或云防火墙。两层规则都要允许 TCP 80 和 443。
先查看 UFW 状态:
sudo ufw status verbose
如果 UFW 已启用,添加 Web 入口规则:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
如果需要启用 UFW,必须先确认 SSH 使用的端口,并提前放行。下面的 22 仅适用于 SSH 确实监听 22 端口的情况:
sudo ufw allow 22/tcp
sudo ufw enable
启用防火墙前建议准备云控制台或带外终端。否则 SSH 端口写错可能导致远程失联。防火墙调整的影响范围是整台服务器,不仅限于 Traefik。
外部端口可以从另一台机器检查:
nc -vz SERVER_PUBLIC_IP 80
nc -vz SERVER_PUBLIC_IP 443
在 Traefik 尚未启动时,端口检查可能显示连接被拒绝;部署后重新检查时,预期应能建立 TCP 连接。
确认系统时间
ACME 证书申请依赖正确的系统时间。先检查时间同步状态:
timedatectl status
重点查看:
System clock synchronized是否为yes;NTP service是否处于运行状态;- 系统时区和当前时间是否明显正确。
时间不准确时,应先修复系统时间同步,再继续证书申请。
安装 Docker 和 Compose
如果服务器上已经能够正常执行以下两个命令,可以跳过安装步骤:
docker version
docker compose version
对于 Ubuntu,可以使用 Docker 官方软件源安装 Engine 和 Compose 插件。执行安装前应确认系统确实是 Ubuntu,不要把下面的仓库地址直接用于其他发行版。
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$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
启动 Docker,并设置为随系统启动:
sudo systemctl enable --now docker
验证服务状态和 Compose 版本:
sudo systemctl is-active docker
docker version
docker compose version
systemctl is-active docker 预期返回 active。如果当前账号没有访问 Docker Socket 的权限,可以暂时在命令前加 sudo,不要为了省略 sudo 而随意修改 Docker Socket 权限。
最后可以执行一个临时容器测试 Docker 是否能够正常拉取镜像:
sudo docker run --rm hello-world
创建 Traefik 工作目录
为 Traefik 单独创建目录,并为 ACME 证书状态文件设置严格权限:
sudo install -d -m 0755 /opt/traefik/letsencrypt
sudo touch /opt/traefik/letsencrypt/acme.json
sudo chmod 600 /opt/traefik/letsencrypt/acme.json
sudo chown -R "$USER":"$USER" /opt/traefik
cd /opt/traefik
创建环境变量文件:
cat > .env <<'EOF'
ACME_EMAIL=admin@example.com
EOF
chmod 600 .env
将 admin@example.com 替换为实际邮箱。该邮箱用于 ACME 账户注册和证书通知,不是网站登录密码。
检查文件权限:
stat -c '%A %a %n' .env letsencrypt/acme.json
acme.json 的权限应为 600。该文件保存证书账户和证书状态,不应提交到公开代码仓库,也不应通过 Web 服务直接提供下载。
编写 Docker Compose 配置
在 /opt/traefik 目录中创建 compose.yaml:
services:
traefik:
image: traefik:v3.0
container_name: traefik
restart: unless-stopped
command:
- "--api.dashboard=false"
- "--providers.docker=true"
- "--providers.docker.exposedbydefault=false"
- "--providers.docker.network=web"
- "--entrypoints.web.address=:80"
- "--entrypoints.websecure.address=:443"
- "--entrypoints.web.http.redirections.entrypoint.to=websecure"
- "--entrypoints.web.http.redirections.entrypoint.scheme=https"
- "--entrypoints.web.http.redirections.entrypoint.permanent=true"
- "--certificatesresolvers.le.acme.email=${ACME_EMAIL}"
- "--certificatesresolvers.le.acme.storage=/letsencrypt/acme.json"
- "--certificatesresolvers.le.acme.httpchallenge=true"
- "--certificatesresolvers.le.acme.httpchallenge.entrypoint=web"
- "--log.level=INFO"
- "--accesslog=true"
ports:
- "80:80"
- "443:443"
volumes:
- "/var/run/docker.sock:/var/run/docker.sock:ro"
- "./letsencrypt:/letsencrypt"
networks:
- web
whoami:
image: traefik/whoami:v1.10
container_name: traefik-whoami
restart: unless-stopped
expose:
- "80"
networks:
- web
labels:
- "traefik.enable=true"
- "traefik.docker.network=web"
- "traefik.http.routers.whoami.rule=Host(`app.example.com`)"
- "traefik.http.routers.whoami.entrypoints=websecure"
- "traefik.http.routers.whoami.tls=true"
- "traefik.http.routers.whoami.tls.certresolver=le"
- "traefik.http.services.whoami.loadbalancer.server.port=80"
networks:
web:
name: web
这里的关键配置如下:
exposedbydefault=false:只有显式写入traefik.enable=true的容器才会被发布;web和websecure:分别监听 80 和 443;redirections.entrypoint:将普通 HTTP 请求跳转到 HTTPS;httpchallenge.entrypoint=web:使用 80 端口完成 ACME HTTP-01 验证;acme.json:持久化证书状态,避免容器重建后丢失;docker.sock:让 Traefik 读取 Docker 标签发现后端服务;whoami没有使用ports,只通过expose在 Docker 网络内部提供 80 端口。
Docker Socket 使用只读文件挂载可以减少文件写入风险,但并不代表 Docker API 完全没有权限风险。不要把 Docker Socket 或 Traefik Dashboard 映射到公网。对隔离要求更高的环境,可以进一步采用独立的 Docker API 访问代理。
替换为实际网站服务
完成 Traefik 连通性验证后,可以把 whoami 服务替换为实际网站容器。下面是一个网站容器监听 8080 端口的标签示例:
website:
image: your-registry/website:1.0
restart: unless-stopped
expose:
- "8080"
networks:
- web
labels:
- "traefik.enable=true"
- "traefik.docker.network=web"
- "traefik.http.routers.website.rule=Host(`app.example.com`)"
- "traefik.http.routers.website.entrypoints=websecure"
- "traefik.http.routers.website.tls=true"
- "traefik.http.routers.website.tls.certresolver=le"
- "traefik.http.services.website.loadbalancer.server.port=8080"
loadbalancer.server.port 指的是容器内部端口,不是宿主机端口。如果网站进程在容器内监听 8080,就填写 8080;不要因为宿主机曾经使用过其他端口而照搬。
如果网站服务属于另一个 Compose 项目,需要让它加入名为 web 的 Docker 网络。两个项目都使用外部网络时,网络声明方式会不同,必须先确认网络是否已经存在:
docker network ls
docker network inspect web
如果网站运行在宿主机而不是容器中,Traefik 容器里的 127.0.0.1 指向 Traefik 容器自身,不是宿主机。此时不能直接把 127.0.0.1:8080 当成后端地址使用,应根据实际部署方式配置可达的宿主机地址或将网站改为加入 Docker 网络。
启动 Traefik 并逐步验证
校验 Compose 配置
在启动前先渲染并校验配置:
cd /opt/traefik
docker compose config --quiet
没有输出且退出状态为 0,通常表示 YAML、环境变量插值和 Compose 结构通过校验。如果出现缩进错误、变量为空或服务字段错误,应先修正,不要直接启动。
可以查看渲染后的关键内容:
docker compose config | sed -n '1,180p'
确认:
- 80 和 443 的端口映射存在;
ACME_EMAIL已替换为实际邮箱;app.example.com已替换为实际域名;- 后端服务和 Traefik 都加入
web网络; - 后端没有不必要的公网
ports映射。
拉取镜像并启动
docker compose pull
docker compose up -d
up -d 只启动当前 Compose 项目中的服务。首次申请证书可能需要短暂等待,期间不要连续删除并重建 ACME 状态文件。
检查容器状态:
docker compose ps
预期 traefik 和 traefik-whoami 都处于 Up 或运行状态。
查看 Traefik 日志:
docker compose logs --tail=100 traefik
重点观察是否存在以下类型的错误:
address already in use:80 或 443 已被其他服务占用;unable to obtain ACME certificate:域名、端口或 ACME 验证失败;- Docker Provider 连接失败:Docker Socket 或容器运行环境不匹配;
- 配置解析失败:命令参数、YAML 或标签格式错误。
验证 HTTP 到 HTTPS 的跳转
从服务器或外部机器执行:
curl -sS -D - -o /dev/null http://app.example.com
预期返回 3xx 状态,并且响应头中包含类似内容:
Location: https://app.example.com/
如果 HTTP 连接超时,优先检查云安全组、UFW 和端口占用。如果能够连接但没有跳转,查看 Traefik 启动参数是否包含 redirections.entrypoint 配置。
验证 HTTPS 和后端路由
证书签发后执行:
curl -sS -D - https://app.example.com -o /tmp/https-response.txt
正常情况下:
- TLS 握手可以完成;
curl不需要使用-k绕过证书校验;- 返回状态通常为
200; - 响应内容来自
whoami或实际网站容器。
查看测试后端返回的内容:
cat /tmp/https-response.txt
如果使用的是 whoami,通常能看到请求主机名、协议和容器信息。它的作用是确认 Traefik 已经完成路由,不代表实际网站页面内容。
检查证书主体和有效期
可以使用 OpenSSL 查看服务器返回的证书:
openssl s_client \
-connect app.example.com:443 \
-servername app.example.com \
</dev/null 2>/dev/null | \
openssl x509 -noout -subject -issuer -dates
-servername 很重要,它会在 TLS 握手中发送 SNI,使服务器返回对应域名的证书。检查结果时关注:
subject或 SAN 是否包含app.example.com;issuer是否为受信任的公开证书机构;notBefore和notAfter是否在合理范围;- 浏览器和普通
curl是否都能完成证书校验。
同时查看 ACME 状态文件是否已经写入数据,但不要直接输出文件内容:
sudo stat -c 'mode=%a size=%s bytes=%n' /opt/traefik/letsencrypt/acme.json
首次成功签发后,文件大小通常会大于 0,并且权限仍应为 600。
检查重启后的持久性
Traefik 配置了 restart: unless-stopped,但仍应验证重启后路由和证书状态没有丢失。重启会造成短暂连接中断,应在维护窗口执行:
cd /opt/traefik
docker compose restart traefik
docker compose ps
curl -sS -D - -o /dev/null https://app.example.com
如果重启后又重新申请证书,通常说明 acme.json 没有正确挂载,或者容器使用了错误的存储路径。
常见异常处理
DNS 正确但证书申请失败
先重新确认解析结果:
dig +short A app.example.com
dig +short AAAA app.example.com
如果 A 记录正确但 AAAA 记录指向另一台机器,部分客户端和 ACME 验证可能优先使用 IPv6,导致访问失败。处理方式是修正 IPv6 路由,或者在未启用 IPv6 时删除错误的 AAAA 记录。
从外部机器检查 80 端口:
curl -sS -D - -o /dev/null http://app.example.com
如果外部无法访问,而服务器本机可以访问,通常应检查:
- 云安全组是否放行 TCP 80;
- UFW 是否放行 TCP 80;
- 服务商是否还有额外的网络 ACL;
- 80 端口是否被其他服务占用;
- 域名是否刚刚修改,外部 DNS 缓存是否仍未更新。
HTTP-01 验证依赖公网入口,不能只用服务器内部访问结果判断成功。
Traefik 容器启动失败
查看完整日志:
docker compose logs --tail=200 traefik
再重新校验 Compose:
docker compose config --quiet
如果提示端口绑定失败,使用以下命令找出进程:
sudo ss -ltnp | grep -E ':(80|443)\b' || true
不要直接执行停止或杀死进程的命令。确认该服务属于当前迁移范围,并已备份配置后,再安排切换。错误停止其他网站入口可能造成整台服务器上的多个站点中断。
HTTPS 返回 404
Traefik 返回 404,通常表示请求没有匹配到路由。重点检查:
- 浏览器访问的域名是否与
Host(...)中的域名完全一致; - 是否访问了服务器 IP,而不是域名;
traefik.enable=true是否存在;- 路由是否绑定了
websecure; - Compose 修改后是否执行了
docker compose up -d; - 实际服务是否使用了不同的 Compose 项目或 Docker 网络。
检查当前容器和网络:
docker compose ps
docker network inspect web
如果访问 https://SERVER_PUBLIC_IP,即使 Traefik 正常运行,也可能因为没有匹配到 Host 规则而返回 404。应使用配置中的域名测试。
HTTPS 返回 502
502 通常说明路由已经匹配,但 Traefik 无法连接后端。依次检查:
docker compose ps
docker compose logs --tail=100 whoami
实际网站服务应检查对应服务名称的日志。常见原因包括:
loadbalancer.server.port写成了宿主机端口;- Traefik 和网站没有加入同一个 Docker 网络;
- 网站进程只监听容器内的
127.0.0.1; - 网站容器虽然运行,但内部应用启动失败;
- 应用实际监听端口与配置文件不一致。
网站应用应监听容器内的 0.0.0.0:端口,这样同一 Docker 网络中的 Traefik 才能连接。
浏览器提示证书不受信任
先不要使用 curl -k 作为最终验证方式。使用 OpenSSL 检查实际证书内容:
openssl s_client \
-connect app.example.com:443 \
-servername app.example.com \
</dev/null 2>/dev/null | \
openssl x509 -noout -subject -issuer -dates
如果返回的是测试环境证书、错误域名证书或过期证书,应检查:
- 是否把 ACME 测试服务地址留在了生产配置中;
acme.json是否包含旧环境数据;- 请求的域名是否与路由规则一致;
- 系统时间是否正确;
- DNS 是否已经指向当前服务器。
反复测试 ACME 配置时,可以暂时使用 ACME 测试服务,避免频繁触发生产环境的申请限制。测试环境签发的证书不会被普通浏览器信任。测试完成后,应恢复生产 ACME 地址,并使用独立的生产存储文件,不要把测试证书状态直接当成生产证书使用。
测试配置示例:
- "--certificatesresolvers.le.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory"
- "--certificatesresolvers.le.acme.storage=/letsencrypt/acme-staging.json"
切回生产时,移除 caserver 参数,并恢复:
- "--certificatesresolvers.le.acme.storage=/letsencrypt/acme.json"
同时确保生产文件存在且权限为 600。
网站出现 HTTP/HTTPS 重定向循环
Traefik 已经负责把外部 HTTP 重定向到 HTTPS。如果后端网站自身没有正确识别反向代理传递的协议,就可能认为外部仍然是 HTTP,反复跳转。
检查应用的站点地址和反向代理设置:
- 公共站点地址应设置为
https://app.example.com; - 应用应能够识别
X-Forwarded-Proto: https; - 应用的可信代理设置应只允许来自 Traefik 或内部网络的代理;
- 不要同时配置互相冲突的外部重定向规则。
如果直接访问后端容器正常,而经过 Traefik 出现循环,优先检查应用对转发头和站点 URL 的处理。
结果检查
完成部署后,可以按以下表格逐项验收:
| 检查项 | 检查命令或方法 | 合格表现 |
|---|---|---|
| DNS | dig +short A app.example.com | 指向当前美国服务器公网 IP |
| IPv6 | dig +short AAAA app.example.com | 无错误 AAAA,或 IPv6 可正常访问 |
| 端口 | 外部执行 nc -vz IP 80/443 | TCP 连接可建立 |
| 容器状态 | docker compose ps | Traefik 和后端处于运行状态 |
| HTTP 入口 | curl -D - http://app.example.com | 返回 3xx 并跳转到 HTTPS |
| HTTPS 证书 | curl https://app.example.com | 不需要 -k,证书校验通过 |
| 路由 | 查看响应内容和状态码 | 请求到达实际后端服务 |
| ACME 状态 | stat acme.json | 文件存在、权限为 600、成功签发后有数据 |
| 端口暴露 | docker compose.yaml 和 ss | 网站只通过 Traefik 对外提供服务 |
| 重启持久性 | docker compose restart traefik | 重启后路由和证书仍然有效 |
如果网站还需要处理登录 Cookie、绝对 URL 或安全跳转,应在浏览器开发者工具中检查响应头、Cookie 的 Secure 属性以及页面资源是否全部使用 HTTPS。
回滚方案
首次部署前,建议备份 Traefik 配置目录。备份文件中可能包含 ACME 状态,应限制访问权限:
sudo cp -a /opt/traefik \
"/opt/traefik.backup.$(date +%Y%m%d-%H%M%S)"
sudo chmod 700 /opt/traefik.backup.*
如果只是回滚最近一次 Compose 配置修改,应恢复已知可用的 compose.yaml,然后重新校验和启动:
cd /opt/traefik
docker compose config --quiet
docker compose up -d
如果需要停止本次 Traefik 部署:
cd /opt/traefik
docker compose down
该命令会停止当前 Compose 项目中的容器,但不会删除绑定目录中的 acme.json。不要在普通回滚时使用 docker compose down -v,也不要直接删除 /opt/traefik/letsencrypt,否则可能丢失证书状态和后续续期所需的数据。
执行 docker compose down 会使由 Traefik 提供入口的网站暂时不可访问。如果服务器原来有其他 Web 入口,应先确认旧服务配置和端口,再恢复旧服务,避免两个服务同时抢占 80/443。
如果 Traefik 不再使用 80/443,并且这些端口没有其他业务依赖,可以删除对应 UFW 规则:
sudo ufw delete allow 80/tcp
sudo ufw delete allow 443/tcp
删除防火墙规则前应确认同一台服务器上没有其他网站、证书验证或 API 服务仍然使用这些端口。
验收与回滚检查项
验收项
- [ ] 域名 A 记录指向当前美国服务器公网 IPv4。
- [ ] AAAA 记录没有指向错误的旧服务器。
- [ ] 云安全组和 UFW 均已放行 TCP 80、443。
- [ ] Docker 与 Compose 版本能够正常运行。
- [ ]
acme.json存在且权限为600。 - [ ] Traefik 容器启动后没有端口冲突和配置解析错误。
- [ ] HTTP 请求能够跳转到 HTTPS。
- [ ] HTTPS 证书的域名、颁发者和有效期正确。
- [ ] HTTPS 请求能够到达实际网站容器。
- [ ] 网站容器没有不必要的公网端口映射。
- [ ] Traefik 重启后,路由和证书状态仍然保留。
回滚项
- [ ] 已备份
compose.yaml、网站原有入口配置和 ACME 状态目录。 - [ ] 已确认
docker compose down的影响范围只包括当前 Compose 项目。 - [ ] 回滚时未使用
docker compose down -v。 - [ ] 恢复旧 Web 入口前,已确认 80/443 不会与 Traefik 同时监听。
- [ ] 删除 UFW 规则前,已确认没有其他服务依赖 80/443。
- [ ] 回滚后重新执行 DNS、端口、HTTP 跳转和 HTTPS 证书检查。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9350.html



