内网服务也要 HTTPS:mkcert 自签证书实战,告别浏览器「不安全」警告

折腾自建服务的兄弟肯定都碰到过这种尴尬:Ad…

折腾自建服务的兄弟肯定都碰到过这种尴尬:AdGuard Home 后台、Uptime Kuma 监控、Portainer 面板、OpenWebUI,全是一堆 http://192.168.x.x:端口 的地址。浏览器每次打开都甩给你一个「不安全」的红字警告,有些手机 App 更是直接连不上。今天就把「内网 HTTPS」这件事一次讲透——用 mkcert 给内网服务签发受信任的证书,让家里所有设备都认,红字彻底消失。

为什么内网也要上 HTTPS

很多人觉得「我又没暴露到公网,HTTP 够用了」。但现实很骨感:浏览器把 HTTP 站点一律当「不安全」,剪贴板读写、摄像头、通知、Service Worker、HTTP/2 这些能力只对 HTTPS 开放;账号密码在内网明文传输,同一个 Wi-Fi 下的恶意设备照样能嗅探;更别说不少客户端和移动端管理工具干脆强制 HTTPS。结论很明确:内网服务,能上 HTTPS 就上,这是让自建服务「体面可用」的基本功。

三种方案,先选对路

  • 公网域名 + DNS-01 证书(acme.sh):要一个真实域名,证书由公网 CA 签发,所有设备天然信任,不用每台装根证书;代价是要有域名、要做 DNS 校验。之前写过 acme.sh 泛域名证书那篇,适合有域名的兄弟。
  • mkcert 自签(本地私有 CA):一条命令生成「本地受信任」的证书,适合没有域名、纯内网 IP 或本地域名访问的场景;代价是要在每台设备上装一次根证书。
  • 企业级私有 CA(Step-CA / easy-rsa):多设备、多服务、要自动续期和吊销的规模场景,配置偏重,家庭 Homelab 一般用不上。

今天重点讲 mkcert,因为它是最贴合「无域名、纯内网」家庭场景、成本最低见效最快的方案。

安装 mkcert

# Debian / Ubuntu:先装 NSS 工具,让根证书能进 Chrome/Firefox 的信任库
sudo apt update && sudo apt install -y libnss3-tools

# 下载 mkcert 二进制并装到 PATH
curl -JLO "https://dl.filippo.io/mkcert/latest?for=linux/amd64"
chmod +x mkcert-v*-linux-amd64
sudo mv mkcert-v*-linux-amd64 /usr/local/bin/mkcert

mkcert -version

macOS 用 brew install mkcert nss,Windows 用 choco install mkcert 或直接下 exe。装完第一件事,生成并安装本地根证书。

生成根证书 + 签发站点证书

# 生成本地 CA,并自动写入当前系统信任库
mkcert -install

# 查看根证书所在目录(后面要给别的设备装)
mkcert -CAROOT

# 给内网 IP 和本地域名签发证书(一次可以写多个)
mkcert -cert-file cert.pem -key-file key.pem \
  192.168.1.10 192.168.1.11 localhost 127.0.0.1 nas.local router.lan

# 私钥权限收紧,别让其他用户读到
chmod 600 key.pem

签完拿到两个文件:cert.pem(证书)和 key.pem(私钥)。上面的 192.168.1.10 换成你服务实际的内网 IP,nas.local 之类的本地域名按需增删。私钥是命根子,务必 chmod 600 收好。

让其他设备信任根证书

证书受不受信任,取决于设备有没有装根证书。只有装了 rootCA.pem 的设备才会认你签出来的证书,否则照样红字警告。rootCA.pem 就在 mkcert -CAROOT 输出的目录里,把它分发给各设备:

  • Windows:拷过去双击,安装到「受信任的根证书颁发机构」。
  • macOS:双击导入「钥匙串访问」,把证书设为「始终信任」。
  • iOS / Android:把 rootCA.pem 发到手机(或挂个临时下载链接)安装;iOS 还要到「设置 → 通用 → 关于本机 → 证书信任设置」里手动打开对该证书的完全信任。
  • Linux 其他机器:把 rootCA.pem 放进 /usr/local/share/ca-certificates/,执行 sudo update-ca-certificates。

简单说:mkcert 这台机器上 mkcert -install 就搞定了,别的设备把 rootCA.pem 装一遍即可,刷新浏览器红字就没了。

给 Nginx / Caddy 接上证书

server {
    listen 443 ssl;
    server_name nas.local 192.168.1.10;

    ssl_certificate     /etc/nginx/certs/cert.pem;
    ssl_certificate_key /etc/nginx/certs/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

# 顺手把 80 端口跳到 443
server {
    listen 80;
    server_name nas.local 192.168.1.10;
    return 301 https://$host$request_uri;
}

Caddy 更省事,两行搞定:

nas.local, 192.168.1.10 {
    tls /etc/caddy/certs/cert.pem /etc/caddy/certs/key.pem
    reverse_proxy 127.0.0.1:8080
}

给 Docker 服务挂证书

面板类服务大多是 Docker 跑的。最通用的做法是前面挂一个 Nginx/Caddy 反代做 TLS 终止,服务本身继续跑 HTTP,证书统一收在反代那一层,管理起来最省心。如果镜像本身支持直接读证书,就把证书目录挂进去,用环境变量指定路径(不同镜像变量名不同,查各自文档)。以 Uptime Kuma 为例:

docker run -d \
  --name uptime-kuma \
  -p 3001:3001 \
  -v /home/cortex/certs:/certs:ro \
  -e SSL_CERT=/certs/cert.pem \
  -e SSL_KEY=/certs/key.pem \
  louislam/uptime-kuma:1

进阶:一个根证书管全家设备

mkcert 本质就是一台私有 CA,rootCA.pem 就是你的「私有根」。设备装一次,之后你用同一个 mkcert 签多少域名、多少 IP 的证书,它们统统都认。所以建议把根证书固定放好(比如丢到 NAS 的共享目录),新设备到手先装一次,一劳永逸。真要上规模——几十台设备、要自动续期、要做吊销——再去折腾 Step-CA,家庭场景没必要。

两个坑要留意

  • 证书会过期:mkcert 默认签 2 年零 3 个月,到期要重签并重新部署,别忘设个提醒。
  • IP 变了证书就失效:证书是绑定 IP/域名的,DHCP 分配的内网 IP 一变就得重签。建议给服务设静态 IP,或者用本地域名(配合 AdGuard Home 的自定义 DNS 记录)统一访问。

总结

内网 HTTPS 不是强迫症,是让自建服务「能放心用」的基本功。没有域名的兄弟,mkcert 是成本最低、见效最快的路:一条命令装 CA、一条命令签证书,剩下就是分发根证书和给服务挂上。有真实域名的,直接上 acme.sh 泛域名证书(之前那篇写过),连客户端装根证书这步都能省掉。把家里的面板、监控、相册都换成绿色小锁,用起来心里才踏实。

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注