三多运维

MoonTV 配置 HTTPS

2026/11/02
25
0

在 fnOS 上给 MoonTV 配置 HTTPS:一次踩透证书、端口与数据卷的实践,tags:

  • Docker
  • fnOS
  • 反向代理
  • HTTPS
  • 家庭服务器
    categories:
  • 折腾记录

本文记录在 fnOS(飞牛 OS)上把 MoonTV(LunaTV)从「http://IP:12345 裸奔」迁到
「https://域名:10086 带证书」的完整过程。
文中域名统一用 tv.example.com 代替,端口沿用 10086,实际部署时替换即可。

为什么值得写这一篇

网上关于「MoonTV 开启 HTTPS」的教程大多只有一句「套个 Nginx 反代」,但真正做起来,会连续撞上四个论文级别的问题:

  1. 应用的 SITE_BASE 到底是干什么的,不设会怎样
  2. 为什么改个部署目录会导致「数据全部消失」
  3. 为什么 80/443 进不来时,HTTPS 依然可以做到
  4. 为什么同一张证书能用在任意端口

这四个问题如果只靠搜索引擎,大概率会得到互相矛盾的答案。所以我把整个决策链条和验证过的结论都写下来。

环境与约束

项目值
系统fnOS 1.2.0800(基于 Debian)
宿主PVE 虚拟机
容器编排Docker + Compose v2
域名解析ddns-go 动态更新 A 记录
应用MoonTV(ghcr.io/moontechlab/lunatv:100.1.3)
存储kvrocks(apache/kvrocks)
证书手动申请,DigiCert DV,SAN 覆盖 tv.example.com

决定性约束:公网 80 和 443 都无法到达这台机器(运营商限制 + 无端口映射)。

这一条直接排斥了 Let's Encrypt 最常见的两种验证方式,也让「标准 443 部署」这条路走不通。后面的所有设计都是从这条约束推出来的。

方案选型:三个结论

结论一:MoonTV 自己不会说 HTTPS

先把事实摆清楚。看官方镜像的三个文件就够:

# Dockerfile
ENV PORT=3000
EXPOSE 3000
CMD ["node", "start.js"]
// start.js —— 它自己连自己都用 http 模块
const TARGET_URL = `http://${process.env.HOSTNAME || 'localhost'}:${process.env.PORT || 3000}/login`;
const req = http.get(TARGET_URL, (res) => { /* ... */ });

package.json 的启动脚本是 next start,产物是 Next.js standalone 的 server.js,基于 http.createServer。

结论:容器里只有一个明文 HTTP 监听器。给它挂证书、加 SSL_CERT 环境变量、改 command 参数,全都没用——进程根本不读。

结论二:SITE_BASE 不是「开启 SSL」的开关

这是最容易误解的一点。官方 README 的环境变量表写的是:

变量说明示例默认
SITE_BASE站点 url形如 https://example.com空

看起来像是 SSL 配置,但 CHANGELOG 说得很明确——100.0.0 版本:

新增对 SITE_BASE 环境变量的支持,解决 m3u8 重写时 base url 错误的问题

这才是它的真实用途。MoonTV 播放时会把资源站的 m3u8 播放列表重写成走自己代理,重写需要把相对路径拼成绝对 URL,就需要知道「我这个站对外地址是什么」。

不设 SITE_BASE,应用就只能靠猜。结果就是:能搜到、点进去一直转圈、播放失败。

所以两者的分工是:

浏览器 ──TLS 加密──▶ Caddy :10086 ──明文──▶ moontv :3000
        ↑ 谁加密?Caddy        ↑ 谁告诉应用"我在 https 后面"?SITE_BASE

SITE_BASE 是 HTTPS 的下游配套,不是替代品。

结论三:证书与端口无关,所以非标端口完全可行

浏览器校验证书时,比对的是地址栏里的主机名,端口从不参与。证书里也只是写「我是谁」:

Subject: CN = tv.example.com
X509v3 Subject Alternative Name:
    DNS:tv.example.com

https://tv.example.com:443、:6789、:10086 用同一张证书,都合法。

这一点不用信我,看 fnOS 自己就行:它的管理界面跑在 6789 而不是 443,浏览器照样显示安全锁。

那为什么不用 ACME 自动签发?

验证方式要求本环境
HTTP-01公网可达 80❌
TLS-ALPN-01公网可达 443❌
DNS-01能用 API 写 TXT 记录✅ 可行,但需 DNS API 凭据 + 自定义 Caddy 镜像

DNS-01 是最优雅的解法(不碰任何入站端口),但要给 Caddy 编入对应 DNS 插件:

FROM caddy:2-builder AS builder
RUN xcaddy build --with github.com/caddy-dns/cloudflare
FROM caddy:2
COPY --from=builder /usr/bin/caddy /usr/bin/caddy

既然手上已有有效证书,直接挂载成本更低。等证书需要全自动续期时,再切 DNS-01 也不迟。

最终架构

        浏览器
           │  https://tv.example.com:10086
           │  (证书:手动上传的那张)
           ▼
   PVE NAT 转发 10086 ──▶ VM:10086
           │
           ▼
   ┌─────────────────┐
   │ caddy (TLS终结) │  :10086
   └────────┬────────┘
            │  http://moontv:3000(容器内网)
            ▼
   ┌─────────────────┐
   │  moontv         │  :3000(不对外发布)
   └────────┬────────┘
            │  redis://moontv-kvrocks:6666
            ▼
   ┌─────────────────┐
   │ moontv-kvrocks  │  数据卷 kvrocks-data
   └─────────────────┘

三个容器,只有一个对外端口。

四个必须知道的坑

坑 1:改部署目录 = 数据「消失」

这一条代价最大,务必先看。

Compose 的卷名带项目前缀,而项目名默认取当前目录名:

/vol2/1000/moontv      → 项目 moontv → 卷 moontv_kvrocks-data
/vol2/1000/nas/motv    → 项目 motv   → 卷 motv_kvrocks-data   ← 全新的空卷

换目录部署时,docker compose up -d 不会报错,只会安静地建一个新空卷。看起来像数据全丢了,其实是两个不同的卷。

两种处理:

volumes:
  kvrocks-data:
    external: true
    name: moontv_kvrocks-data   # 显式指向旧卷

或者干脆固定项目名:docker compose -p moontv up -d。

动手前先看清楚:

docker volume ls | grep kvrocks
docker inspect moontv-kvrocks --format '{{range .Mounts}}{{.Name}} -> {{.Destination}}{{end}}'

坑 2:Cookie 不区分端口

按 RFC 6265,Cookie 的作用域是域名 + 路径,不含端口。所以:

https://tv.example.com:6789    ← fnOS 管理界面
https://tv.example.com:10086   ← MoonTV

这两者共享同一套 Cookie。如果用了同名 Cookie,后登录的会覆盖前面的,表现为「开 MoonTV 后 fnOS 掉登录」。

多数情况相安无事(Cookie 名不同),一旦遇到,唯一干净的解法是给 MoonTV 独立子域。

坑 3:域名有 AAAA 记录,手机却打不开

ddns-go 常常同时更新 A 和 AAAA。手机 4G/5G 优先走 IPv6,如果 PVE 或防火墙只给 IPv4 做了转发,就会出现:

  • 电脑(IPv4)正常打开
  • 手机(IPv6 优先)转半天、超时

排查:

getent hosts tv.example.com          # 看有没有 AAAA
curl -4 -k -I https://tv.example.com:10086/
curl -6 -k -I https://tv.example.com:10086/

最简单的处理:在 ddns-go 里关掉 AAAA,只保留 A。

坑 4:本地测通了,不代表外网能通

curl https://127.0.0.1:10086/ 这种测法有陷阱。Caddy 按 SNI 匹配站点,用 IP 去连时 SNI 也是 IP,匹配不到任何 site 块,握手直接失败。

正确做法是让 SNI 与 Host 都是域名:

curl -k -sI --resolve tv.example.com:10086:127.0.0.1 https://tv.example.com:10086/

部署实施

目录结构

/vol2/1000/nas/motv/
├── docker-compose.yml
├── Caddyfile
├── .env                    # 凭据,600 权限
├── certs/
│   ├── tv.example.com.crt  # 叶子证书 + 中间证书
│   └── tv.example.com.key
├── install-motv.sh
└── kvrocks-backup-*.tgz

证书直接放在项目根目录即可,脚本会自动识别文件名并归位到 certs/。

一键脚本

整个流程——证书整理与校验、数据卷备份与沿用、随机密码生成、配置生成、部署、四层验证——合并成下面一个脚本。保存为 install-motv.sh,改顶部四个变量后执行 sudo bash install-motv.sh。

#!/bin/bash
# =============================================================================
# MoonTV (LunaTV) HTTPS 一键部署
#   - 自动识别并校验证书(SAN / 配对 / 有效期)
#   - 自动沿用旧数据卷(避免重建后数据"消失")
#   - 自动生成随机强密码到 .env
#   - 自动生成 docker-compose.yml 与 Caddyfile
#   - 部署后做四层验证
#
# 用法:sudo bash install-motv.sh
# 适用:fnOS / Debian / Ubuntu,Docker + Compose v2,证书已手动上传
# =============================================================================
set -uo pipefail

# ----------------------------- 按需修改 ----------------------------------
DOMAIN="tv.example.com"       # 证书域名
PORT="10086"                  # 对外 HTTPS 端口
PROJ="/vol2/1000/nas/motv"    # 项目目录(证书放这里)
OWNER_USER="moontv"           # 站长用户名,切勿随意改动
# -------------------------------------------------------------------------

SITE_BASE="https://${DOMAIN}:${PORT}"
TS=$(date +%Y%m%d-%H%M%S)

ok()   { printf '\033[32m[ OK ]\033[0m %s\n' "$*"; }
inf()  { printf '\033[36m[INFO]\033[0m %s\n' "$*"; }
warn() { printf '\033[33m[WARN]\033[0m %s\n' "$*"; }
bad()  { printf '\033[31m[FAIL]\033[0m %s\n' "$*"; }
step() { printf '\n\033[1m=== %s ===\033[0m\n' "$*"; }
die()  { bad "$*"; exit 1; }

# ============================== 0. 前置检查 ==============================
step "0/8 前置检查"

[ "$(id -u)" -eq 0 ] || die "请用 root 执行"
[ -d "$PROJ" ] || die "项目目录不存在: $PROJ"
cd "$PROJ" || die "无法进入 $PROJ"

for c in docker openssl; do
  command -v "$c" >/dev/null || die "缺少命令: $c"
done
docker compose version >/dev/null 2>&1 || die "docker compose v2 不可用"

ok "环境就绪:root / docker compose / openssl"
inf "域名 ${DOMAIN}  端口 ${PORT}  目录 ${PROJ}"

# ============================== 1. 数据卷 ==============================
step "1/8 数据卷保护"

USE_EXTERNAL=""
OLD_VOL=""
mapfile -t VOLS < <(docker volume ls --format '{{.Name}}' | grep -i kvrocks || true)

if [ ${#VOLS[@]} -gt 0 ]; then
  # 优先选择当前被 kvrocks 容器挂载的那个
  for v in "${VOLS[@]}"; do
    if docker ps -a --filter "volume=$v" --format '{{.Names}}' | grep -qi kvrocks; then
      OLD_VOL="$v"; break
    fi
  done
  # 没有容器在用时,取第一个
  [ -z "$OLD_VOL" ] && OLD_VOL="${VOLS[0]}"

  inf "发现数据卷: $OLD_VOL"

  BK="${PROJ}/kvrocks-backup-${TS}.tgz"
  if docker run --rm -v "${OLD_VOL}":/data -v "${PROJ}":/backup alpine \
       tar czf "/backup/kvrocks-backup-${TS}.tgz" -C /data . >/dev/null 2>&1; then
    ok "已备份 -> $(basename "$BK") ($(du -h "$BK" 2>/dev/null | cut -f1))"
  else
    warn "备份失败(卷可能为空),继续"
  fi

  USE_EXTERNAL="$OLD_VOL"
else
  warn "未发现 kvrocks 卷,将创建新卷(首次部署属正常)"
fi

# ============================== 2. 证书 ==============================
step "2/8 证书识别与校验"

mkdir -p certs
is_cert() { openssl x509 -in "$1" -noout >/dev/null 2>&1; }
is_key()  { openssl pkey  -in "$1" -noout >/dev/null 2>&1; }

CAND_CERT=(); CAND_KEY=()
shopt -s nullglob
for f in *.crt *.pem *.cer *.key; do
  [ -f "$f" ] || continue
  is_cert "$f" && CAND_CERT+=("$f")
  is_key  "$f" && CAND_KEY+=("$f")
done
shopt -u nullglob

[ ${#CAND_CERT[@]} -ge 1 ] || die "未找到证书文件(*.crt / *.pem)"
[ ${#CAND_KEY[@]}  -ge 1 ] || die "未找到私钥文件(*.key / *.pem)"

# 单个 PEM 同时含证书与私钥 -> 拆分
if [ ${#CAND_CERT[@]} -eq 1 ] && [ ${#CAND_KEY[@]} -eq 1 ] \
   && [ "${CAND_CERT[0]}" = "${CAND_KEY[0]}" ]; then
  BOTH="${CAND_CERT[0]}"
  inf "检测到 ${BOTH} 同时包含证书与私钥,自动拆分"
  awk '/BEGIN CERTIFICATE/,/END CERTIFICATE/' "$BOTH" > certs/${DOMAIN}.crt
  awk '/BEGIN .*PRIVATE KEY/,/END .*PRIVATE KEY/' "$BOTH" > certs/${DOMAIN}.key
else
  SRC_CERT=""
  for f in "${CAND_CERT[@]}"; do
    if openssl x509 -in "$f" -noout -ext subjectAltName 2>/dev/null | grep -q "$DOMAIN"; then
      SRC_CERT="$f"; break
    fi
  done
  [ -n "$SRC_CERT" ] || die "没有 SAN 包含 ${DOMAIN} 的证书"

  CERT_PUB=$(openssl x509 -in "$SRC_CERT" -noout -pubkey 2>/dev/null | openssl md5)
  SRC_KEY=""
  for k in "${CAND_KEY[@]}"; do
    [ "$(openssl pkey -in "$k" -pubout 2>/dev/null | openssl md5)" = "$CERT_PUB" ] \
      && { SRC_KEY="$k"; break; }
  done
  [ -n "$SRC_KEY" ] || die "所有私钥都无法与证书配对"

  cp -f "$SRC_CERT" certs/${DOMAIN}.crt
  cp -f "$SRC_KEY"  certs/${DOMAIN}.key
  inf "证书: $SRC_CERT"
  inf "私钥: $SRC_KEY"
fi

chmod 644 certs/${DOMAIN}.crt
chmod 600 certs/${DOMAIN}.key

openssl x509 -in certs/${DOMAIN}.crt -noout -ext subjectAltName 2>/dev/null | grep -q "$DOMAIN" \
  || die "SAN 不含 ${DOMAIN}"
ok "SAN 校验通过"

[ "$(openssl x509 -in certs/${DOMAIN}.crt -noout -pubkey | openssl md5)" = \
  "$(openssl pkey -in certs/${DOMAIN}.key -pubout | openssl md5)" ] || die "证书与私钥不配对"
ok "证书私钥配对通过"

openssl x509 -in certs/${DOMAIN}.crt -noout -checkend 0 >/dev/null || die "证书已过期"
END=$(openssl x509 -in certs/${DOMAIN}.crt -noout -enddate | cut -d= -f2)
ok "证书有效期至: $END"

# ============================== 3. 密码 ==============================
step "3/8 凭据"

if [ -f .env ] && grep -q '^MOONTV_PASSWORD=' .env; then
  inf ".env 已存在,保留现有密码(如需轮换:删除 .env 后重跑)"
  NEWPW=$(grep '^MOONTV_PASSWORD=' .env | cut -d= -f2-)
else
  NEWPW=$(openssl rand -base64 48 | tr -dc 'A-Za-z0-9' | cut -c1-24)
  [ ${#NEWPW} -eq 24 ] || die "密码生成失败"
  printf '# MoonTV 运行时凭据,勿外传\nMOONTV_USERNAME=%s\nMOONTV_PASSWORD=%s\n' \
    "$OWNER_USER" "$NEWPW" > .env
  chmod 600 .env
  ok "已生成 24 位随机密码并写入 .env(600)"
fi

# ============================== 4. Caddyfile ==============================
step "4/8 生成 Caddyfile"

[ -f Caddyfile ] && cp -f Caddyfile "Caddyfile.bak-${TS}"

cat > Caddyfile <<EOF
{
	auto_https disable_redirects
}

https://${DOMAIN}:${PORT} {
	encode zstd gzip

	tls /certs/${DOMAIN}.crt /certs/${DOMAIN}.key

	reverse_proxy moontv:3000

	header {
		Strict-Transport-Security "max-age=31536000"
		X-Content-Type-Options "nosniff"
		X-Frame-Options "SAMEORIGIN"
		Referrer-Policy "strict-origin-when-cross-origin"
		X-Robots-Tag "noindex, nofollow, noarchive"
		-Server
	}
}
EOF
ok "Caddyfile 已生成"

# ============================== 5. compose ==============================
step "5/8 生成 docker-compose.yml"

[ -f docker-compose.yml ] && cp -f docker-compose.yml "docker-compose.yml.bak-${TS}"

if [ -n "$USE_EXTERNAL" ]; then
  VOL_BLOCK="  kvrocks-data:
    external: true
    name: ${USE_EXTERNAL}"
else
  VOL_BLOCK="  kvrocks-data:"
fi

cat > docker-compose.yml <<EOF
services:
  moontv:
    image: ghcr.io/moontechlab/lunatv:100.1.3
    container_name: moontv
    restart: unless-stopped
    environment:
      - USERNAME=\${MOONTV_USERNAME}
      - PASSWORD=\${MOONTV_PASSWORD}
      - NEXT_PUBLIC_STORAGE_TYPE=kvrocks
      - KVROCKS_URL=redis://moontv-kvrocks:6666
      - SITE_BASE=${SITE_BASE}
      - NEXT_PUBLIC_SITE_NAME=MoonTV
    networks:
      - moontv-network
    depends_on:
      - moontv-kvrocks

  moontv-kvrocks:
    image: apache/kvrocks
    container_name: moontv-kvrocks
    restart: unless-stopped
    volumes:
      - kvrocks-data:/var/lib/kvrocks
    networks:
      - moontv-network

  caddy:
    image: caddy:2-alpine
    container_name: moontv-caddy
    restart: unless-stopped
    ports:
      - "${PORT}:${PORT}"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - ./certs:/certs:ro
      - caddy_data:/data
      - caddy_config:/config
    networks:
      - moontv-network
    depends_on:
      - moontv

networks:
  moontv-network:
    driver: bridge

volumes:
${VOL_BLOCK}
  caddy_data:
  caddy_config:
EOF
ok "docker-compose.yml 已生成"

docker compose config >/dev/null 2>&1 || die "compose 语法错误"
ok "compose 语法校验通过"

# ============================== 6. 部署 ==============================
step "6/8 部署"

for c in moontv-caddy moontv moontv-kvrocks; do
  docker ps -a --format '{{.Names}}' | grep -qx "$c" && docker rm -f "$c" >/dev/null 2>&1
done

docker compose pull >/dev/null 2>&1 || warn "镜像拉取有告警,使用本地缓存"
docker compose up -d
sleep 5
docker compose ps | sed 's/^/    /'

# ============================== 7. 验证 ==============================
step "7/8 分层验证"

RC=0
for c in moontv moontv-kvrocks moontv-caddy; do
  if docker ps --format '{{.Names}}' | grep -qx "$c"; then ok "$c 运行中"; else bad "$c 未运行"; RC=1; fi
done

docker exec moontv-caddy wget -qO- --timeout=5 http://moontv:3000/ >/dev/null 2>&1 \
  && ok "caddy -> moontv:3000 内网连通" || { bad "caddy 无法访问 moontv:3000"; RC=1; }

SUBJ=$(echo | openssl s_client -connect "127.0.0.1:${PORT}" -servername "$DOMAIN" 2>/dev/null \
       | openssl x509 -noout -subject 2>/dev/null || true)
echo "$SUBJ" | grep -q "$DOMAIN" \
  && ok "TLS 证书已加载: $SUBJ" || { bad "未取到证书"; RC=1; }

CODE=$(curl -k -s -o /dev/null -w '%{http_code}' --max-time 8 \
       --resolve "${DOMAIN}:${PORT}:127.0.0.1" "https://${DOMAIN}:${PORT}/" 2>/dev/null)
[ -n "$CODE" ] || CODE=000
case "$CODE" in
  200|302|307|308) ok "HTTPS 全链路通(HTTP $CODE)";;
  *) bad "HTTPS 异常(HTTP $CODE)"; RC=1;;
esac

docker exec moontv env 2>/dev/null | grep -qx "SITE_BASE=${SITE_BASE}" \
  && ok "SITE_BASE=${SITE_BASE}" || { warn "SITE_BASE 未按预期生效"; RC=1; }

# ============================== 8. 汇总 ==============================
step "8/8 完成"

if [ "$RC" -eq 0 ]; then
  cat <<SUMMARY

  访问地址 : ${SITE_BASE}
  用户名   : ${OWNER_USER}
  密码     : ${NEWPW}
  凭据文件 : ${PROJ}/.env (600)
  证书到期 : ${END}
  数据备份 : ${PROJ}/kvrocks-backup-${TS}.tgz

  剩余手工步骤:
    1) 端口转发 ${PORT} -> 本机 ${PORT}
    2) 外网访问验证(手机 4G)
    3) 后台关闭「允许注册」

SUMMARY
else
  bad "存在失败项,请检查上面输出"
  echo "  排错: docker logs --tail 50 moontv-caddy"
  exit 1
fi

脚本幂等:重复执行会保留 .env 里已有的密码,只重新生成配置并重建容器。想轮换密码就删掉 .env 再跑一次。

生成的两个配置文件

脚本会写出这两个文件,贴出来方便理解结构(不需要手动创建)。

docker-compose.yml 的关键部分:

services:
  moontv:
    image: ghcr.io/moontechlab/lunatv:100.1.3
    environment:
      - USERNAME=${MOONTV_USERNAME}
      - PASSWORD=${MOONTV_PASSWORD}
      - NEXT_PUBLIC_STORAGE_TYPE=kvrocks
      - KVROCKS_URL=redis://moontv-kvrocks:6666
      - SITE_BASE=https://tv.example.com:10086   # 必须带端口
    # 注意:没有 ports,不对外暴露

  caddy:
    image: caddy:2-alpine
    ports:
      - "10086:10086"                            # 唯一对外端口
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - ./certs:/certs:ro

Caddyfile:

{
	auto_https disable_redirects
}

https://tv.example.com:10086 {
	encode zstd gzip
	tls /certs/tv.example.com.crt /certs/tv.example.com.key
	reverse_proxy moontv:3000

	header {
		Strict-Transport-Security "max-age=31536000"
		X-Content-Type-Options "nosniff"
		X-Frame-Options "SAMEORIGIN"
		X-Robots-Tag "noindex, nofollow, noarchive"
		-Server
	}
}

验证

部署完不要只看「容器起来了」,要分层验证。四层全过才算真的通:

DOMAIN=tv.example.com
PORT=10086

# 第 1 层:容器
docker compose ps

# 第 2 层:内网连通(Caddy 能否访问后端)
docker exec moontv-caddy wget -qO- --timeout=5 http://moontv:3000/ >/dev/null && echo "内网 OK"

# 第 3 层:TLS 本身(证书是否被正确加载)
echo | openssl s_client -connect 127.0.0.1:$PORT -servername $DOMAIN 2>/dev/null \
  | openssl x509 -noout -subject -issuer -enddate

# 证书链是否完整(2 = 叶子 + 中间证书)
echo | openssl s_client -connect 127.0.0.1:$PORT -servername $DOMAIN -showcerts 2>/dev/null \
  | grep -c "BEGIN CERTIFICATE"

# 第 4 层:HTTPS 全链路(注意 --resolve,让 SNI 也是域名)
curl -k -sI --resolve $DOMAIN:$PORT:127.0.0.1 https://$DOMAIN:$PORT/

# 附加:外网
curl -4 -k -sI https://$DOMAIN:$PORT/

期望结果:

subject=CN = tv.example.com
issuer=... DigiCert ...
2                                   ← 证书链完整
HTTP/2 307                          ← 307 是 MoonTV 未登录时的正常跳转
via: 1.1 Caddy

看到 307 且带 via: 1.1 Caddy,说明整条链路都通了。

排错

现象原因处理
TCP 能连但立刻 reset,无证书容器在崩溃重启,宿主端口由 docker-proxy 占着docker logs moontv-caddy
open /certs/xxx: no such filecerts/ 为空或文件名不符重新跑脚本的证书步骤
502 Bad Gateway反代目标服务名错,或后端没起检查 reverse_proxy 后的服务名
bind: address already in use端口被占用换端口,同步改 Caddyfile、compose、SITE_BASE
no peer certificate测试时 SNI 用了 IP加 --resolve 或 -servername
浏览器证书警告访问的域名与证书 SAN 不符只能用证书覆盖的域名
本地通、外网不通未做端口转发 / DDNS 未更新检查 NAT 与 nslookup
电脑能开、手机不能IPv6 未放行关掉 AAAA 或放行 IPv6
能打开但不能播放SITE_BASE 没生效或漏端口F12 看 m3u8 地址,修正后重建

最常用的两条:

docker logs --tail 50 moontv-caddy      # Caddy 侧
docker logs --tail 50 moontv            # 应用侧

安全加固

密码不要写在 compose 里

改造前(明文,docker inspect 和任何配置备份都能看到):

      - PASSWORD=明文密码

改造后:

      - PASSWORD=${MOONTV_PASSWORD}
# .env
MOONTV_USERNAME=moontv
MOONTV_PASSWORD=(24 位随机串)
chmod 600 .env

重要:USERNAME 绝对不能改。MoonTV 的播放记录、收藏、观看进度都按 username 存进 kvrocks,改用户名等于换账号,历史数据会「消失」。

关闭公网注册

登录后台 → 用户管理 → 关闭「允许注册」。这比密码强度更重要——开放注册意味着任何人都能用你的实例。

禁止被搜索引擎收录

在 Caddyfile 的 header 里加:

	X-Robots-Tag "noindex, nofollow, noarchive"
	-Server

自用影视站一旦被爬虫收录,等于公开分享。

钉住镜像版本

    image: ghcr.io/moontechlab/lunatv:100.1.3   # 而不是 :latest

latest 意味着某次重启可能拉到改了配置格式的新版本。

运维

证书续期

新证书到手后:

cd /vol2/1000/nas/motv
cp 新证书.crt   certs/tv.example.com.crt
cp 新私钥.key   certs/tv.example.com.key
chmod 644 certs/tv.example.com.crt
chmod 600 certs/tv.example.com.key
docker exec moontv-caddy caddy reload --config /etc/caddy/Caddyfile

reload 是热加载,不中断正在播放的会话。

到期前自查:

openssl x509 -in certs/tv.example.com.crt -noout -enddate

备份与恢复

# 备份
VOL=$(docker volume ls --format '{{.Name}}' | grep -i kvrocks | head -1)
docker run --rm -v "$VOL":/data -v "$(pwd)":/backup alpine \
  tar czf /backup/kvrocks-backup-$(date +%Y%m%d).tgz -C /data .

# 恢复
docker run --rm -v "$VOL":/data -v "$(pwd)":/backup alpine \
  sh -c "cd /data && tar xzf /backup/kvrocks-backup-YYYYMMDD.tgz"

升级

docker compose pull moontv
docker compose up -d moontv      # 只重建 moontv,kvrocks 不动

复盘清单

这次折腾下来,值得记下来的判断:

  1. 先分清「谁负责加密」,再谈配置。容器不会说 TLS,就不要在容器里找开关。
  2. SITE_BASE 是地址声明,不是加密开关。它影响的是 m3u8 重写后的 URL,不设会导致能搜到但播不了。
  3. 证书认域名不认端口。80/443 进不来不等于不能上 HTTPS。
  4. 看到「数据消失了」先去查卷名,大概率是项目名变了导致换了空卷,而不是数据真丢了。
  5. 本地测 HTTPS 要带 SNI,否则会得出「服务挂了」的错误结论。
  6. Cookie 不分端口,同域名不同端口会共享登录态。
  7. 手机打不开先怀疑 IPv6,因为移动网络优先走 AAAA。

最后一条经验:把「验证」写成脚本。人眼看到 Up 就容易以为通了,实际上 TLS 可能根本没握手、SITE_BASE 可能压根没生效。分层验证花的那几分钟,远比上线后发现播不了再回头排查划算。