如何在美国服务器上配置Traefik网关,为网站提供HTTPS入口?

发布人:A5数据发布时间:2026-11-14 10:31阅读量:30

在美国服务器上为网站配置 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 LTScat /etc/os-release
服务器网络公网 IPv4;IPv6 可选查看服务商控制台和 ip addr
域名app.example.comdig A/AAAA
云防火墙放行 TCP 80、443服务商安全组或网络 ACL
系统防火墙放行 TCP 80、443ufw status verbose
容器运行环境Docker Engine 与 Compose v2docker 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

如果外部无法访问,而服务器本机可以访问,通常应检查:

  1. 云安全组是否放行 TCP 80;
  2. UFW 是否放行 TCP 80;
  3. 服务商是否还有额外的网络 ACL;
  4. 80 端口是否被其他服务占用;
  5. 域名是否刚刚修改,外部 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 的处理。

结果检查

完成部署后,可以按以下表格逐项验收:

检查项检查命令或方法合格表现
DNSdig +short A app.example.com指向当前美国服务器公网 IP
IPv6dig +short AAAA app.example.com无错误 AAAA,或 IPv6 可正常访问
端口外部执行 nc -vz IP 80/443TCP 连接可建立
容器状态docker compose psTraefik 和后端处于运行状态
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

相关推荐