局域网访问不再裸奔:wrong-notebook HTTPS 配置与屏幕截图功能启用教程
局域网访问不再裸奔:wrong-notebook HTTPS 配置与屏幕截图功能启用教程
wrong-notebook 是一款可自托管的 AI 智能错题本,支持拍照识题、AI 解答、知识点标签、举一反三与组卷打印,还能跟踪每题的掌握度。但在局域网中用 http:// 访问时,浏览器的"屏幕截图"录题按钮会因安全限制而消失,账号密码也在明文传输。这篇教程带你用 3 种方案完成 wrong-notebook HTTPS 配置,一步到位启用屏幕截图功能,让局域网访问不再"裸奔"。
为什么局域网访问必须配置 HTTPS?
wrong-notebook 上传页底部提供了 3 种录题方式:拍照上传、手动输入,以及 屏幕截图。其中屏幕截图依赖浏览器的 getDisplayMedia() API(源码见 src/lib/hooks/use-upload-files.ts),而该 API 有一个硬性前提:
浏览器只在安全上下文(HTTPS 或
localhost)中才允许调用它。
也就是说:
| 访问方式 | 屏幕截图按钮 | 数据传输安全 |
|---|---|---|
http://192.168.x.x:3000(局域网 IP) |
❌ 不显示 | ❌ 明文 |
http://localhost:3000 |
✅ 可用 | ✅ 本机 |
https://你的IP或域名 |
✅ 可用 | ✅ 加密 |
好消息是:wrong-notebook 内置了 HTTPS 代理(https-server.js),容器启动时会自动生成自签名证书,无需手动装 Nginx、不用手动申请证书,非常适合家庭局域网场景。完整说明见官方文档 doc/HTTPS_SETUP.md。
3 种方案速查:按你的设备数量选
| 场景 | 推荐方案 | 复杂度 |
|---|---|---|
| 局域网 + 1-2 台设备 | 浏览器安全例外 | ⭐ 最简单 |
| 局域网 + 多台设备 / iOS | 内置 HTTPS(自动证书) | ⭐⭐ 推荐 |
| 公网 + 域名 | 内置 HTTPS + Let's Encrypt | ⭐⭐ |
方案零:浏览器安全例外(1-2 台设备最快生效)
如果只有一两台设备访问,可以不动服务器,直接在浏览器里把局域网地址标记为"安全源",30 秒搞定。
Chrome / Edge 设置步骤
- 地址栏输入
chrome://flags/#unsafely-treat-insecure-origin-as-secure - 在输入框填入你的访问地址(记得带端口),如
http://192.168.1.100:3000 - 下拉选择 Enabled,点击 Relaunch 重启浏览器
- 刷新页面,屏幕截图按钮就会出现 ✅
Firefox 设置步骤
- 地址栏输入
about:config - 搜索
media.devices.insecure.enabled - 设为
true,刷新页面即可
⚠️ 限制:每台设备都要单独配置,且 iOS Safari 不支持此方法。如果家里有平板、手机多台设备,建议直接上方案一。
方案一:内置 HTTPS 自动证书(多设备推荐)
这是官方推荐的局域网方案,核心就是仓库里现成的 docker-compose.https.yml,只需要改 4 个环境变量:
environment:
# === 必须配置(请修改) ===
- NEXTAUTH_URL=https://YOUR_IP_OR_DOMAIN # 你的完整访问地址
- NEXTAUTH_SECRET=your_secret_key_here # 会话密钥,自己定一个长串
- AUTH_TRUST_HOST=true
# === HTTPS 配置 ===
- HTTPS_ENABLED=true # 开启内置 HTTPS
- CERT_DOMAIN=YOUR_IP_OR_DOMAIN # 你的 IP 或域名,如 192.168.1.100
关键环境变量速查:
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
HTTPS_ENABLED |
是 | - | 设为 true 启用内置 HTTPS |
CERT_DOMAIN |
否 | localhost |
自动证书中的 CN,填你的 IP 或域名 |
NEXTAUTH_URL |
是 | - | 完整访问地址,必须是 https:// 开头 |
AUTH_TRUST_HOST |
是 | - | 固定填 true |
HTTPS_PORT |
否 | 443 |
HTTPS 监听端口 |
三步启动并验证证书生成
# 1. 启动(注意 -f 指定 https 编排文件)
docker-compose -f docker-compose.https.yml up -d
# 2. 查看日志确认证书已自动生成
docker logs wrong-notebook | grep -i cert
# 输出: [Entrypoint] 自签名证书生成成功: CN=192.168.1.100
证书自动生成逻辑在 docker-entrypoint.sh:检测到 HTTPS_ENABLED=true 且 ./certs 目录里没有证书时,会用 openssl req -x509 现场签发一张自签名证书,并通过 https-server.js 将 443 端口的请求代理到内部的 HTTP 3000 端口。
最后把浏览器地址换成 https://192.168.1.100,首次访问点击 高级 → 继续访问 即可。之后无论家里哪台设备、包括 iPad 上的 Safari,屏幕截图按钮都会正常显示:
使用自定义证书与公网域名部署
如果希望彻底消除"不安全"警告,或者要部署到公网,可以放入自己的证书。把证书放到挂载的 ./certs 目录:
certs/
├── cert.pem # 证书
└── key.pem # 私钥
容器启动时会自动检测并使用已有证书,不再重复生成。公网域名建议用免费的 Let's Encrypt:
# 1. 获取证书
sudo apt install certbot
sudo certbot certonly --standalone -d your-domain.com
# 2. 复制证书到项目目录
mkdir -p certs
sudo cp /etc/letsencrypt/live/your-domain.com/fullchain.pem certs/cert.pem
sudo cp /etc/letsencrypt/live/your-domain.com/privkey.pem certs/key.pem
再把 NEXTAUTH_URL 和 CERT_DOMAIN 改成你的域名,重新启动容器即可。⚠️ Let's Encrypt 证书 90 天到期,记得配置 certbot renew 定时续期并重启容器。
常见问题快问快答
Q:证书过期了怎么办?
自签名证书:删除 ./certs 目录后重启容器,会自动重新生成:
rm -rf ./certs
docker-compose -f docker-compose.https.yml restart
Q:浏览器一直提示"您的连接不是私密连接"?
自签名证书显示警告属于正常现象,点"高级 → 继续"即可。若想让所有设备免警告,可把 cert.pem 导入系统信任:Windows 双击证书安装到"受信任的根证书颁发机构";macOS 在钥匙串中设为"始终信任";iOS 通过 AirDrop 安装后在"证书信任设置"中启用完全信任。
Q:群晖 NAS 如何配置?
可直接用 DSM 自带的反向代理:控制面板 → 登录门户 → 高级 → 反向代理服务器,新建一条规则:来源选 HTTPS + 自定义端口,目的地填 http://localhost:3000,群晖会自动使用其 SSL 证书。注意同时把 NEXTAUTH_URL 改为你的外部 HTTPS 地址。
Q:配置了 HTTPS,为什么手机浏览器还是没有截图按钮?
个别移动浏览器不支持 getDisplayMedia(),此时改用拍照上传、从剪贴板粘贴或直接拖入图片即可,录题效果一致(详见 doc/wiki/FAQ.md)。
总结与延伸
- 只有一两台设备:用 浏览器安全例外,30 秒生效
- 多台设备 / 有 iOS:用
docker-compose.https.yml内置 HTTPS,容器自动签证书 - 公网域名:加一层 Let's Encrypt 证书,长期免警告
配置完成后,wrong-notebook 在局域网里既保护了登录凭证,又解锁了屏幕截图录题的完整能力。想深入了解部署细节,可以继续看:
- HTTPS 完整指南:doc/HTTPS_SETUP.md
- 部署总览(含群晖 / 飞牛 / 通用 Docker):doc/wiki/Deployment.md
- 屏幕截图功能源码:src/lib/hooks/use-upload-files.ts
- HTTPS 代理实现:https-server.js


