在 fnOS 上给 MoonTV 配置 HTTPS:一次踩透证书、端口与数据卷的实践,tags:
本文记录在 fnOS(飞牛 OS)上把 MoonTV(LunaTV)从「
http://IP:12345裸奔」迁到
「https://域名:10086带证书」的完整过程。
文中域名统一用tv.example.com代替,端口沿用10086,实际部署时替换即可。
网上关于「MoonTV 开启 HTTPS」的教程大多只有一句「套个 Nginx 反代」,但真正做起来,会连续撞上四个论文级别的问题:
SITE_BASE 到底是干什么的,不设会怎样这四个问题如果只靠搜索引擎,大概率会得到互相矛盾的答案。所以我把整个决策链条和验证过的结论都写下来。
| 项目 | 值 |
|---|---|
| 系统 | 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 部署」这条路走不通。后面的所有设计都是从这条约束推出来的。
先把事实摆清楚。看官方镜像的三个文件就够:
# 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,浏览器照样显示安全锁。
| 验证方式 | 要求 | 本环境 |
|---|---|---|
| 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
└─────────────────┘
三个容器,只有一个对外端口。
这一条代价最大,务必先看。
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}}'
按 RFC 6265,Cookie 的作用域是域名 + 路径,不含端口。所以:
https://tv.example.com:6789 ← fnOS 管理界面
https://tv.example.com:10086 ← MoonTV
这两者共享同一套 Cookie。如果用了同名 Cookie,后登录的会覆盖前面的,表现为「开 MoonTV 后 fnOS 掉登录」。
多数情况相安无事(Cookie 名不同),一旦遇到,唯一干净的解法是给 MoonTV 独立子域。
ddns-go 常常同时更新 A 和 AAAA。手机 4G/5G 优先走 IPv6,如果 PVE 或防火墙只给 IPv4 做了转发,就会出现:
排查:
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。
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 file | certs/ 为空或文件名不符 | 重新跑脚本的证书步骤 |
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 # 应用侧
改造前(明文,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 不动
这次折腾下来,值得记下来的判断:
SITE_BASE 是地址声明,不是加密开关。它影响的是 m3u8 重写后的 URL,不设会导致能搜到但播不了。最后一条经验:把「验证」写成脚本。人眼看到 Up 就容易以为通了,实际上 TLS 可能根本没握手、SITE_BASE 可能压根没生效。分层验证花的那几分钟,远比上线后发现播不了再回头排查划算。