局域网访问不再裸奔:wrong-notebook HTTPS 配置与屏幕截图功能启用教程

原创2026-11-14 23:57:381,925 阅读
文章标签:教育人工智能AI 应用前端后端多模态认证鉴权桌面应用移动开发语音

局域网访问不再裸奔:wrong-notebook HTTPS 配置与屏幕截图功能启用教程

wrong-notebook 是一款可自托管的 AI 智能错题本,支持拍照识题、AI 解答、知识点标签、举一反三与组卷打印,还能跟踪每题的掌握度。但在局域网中用 http:// 访问时,浏览器的"屏幕截图"录题按钮会因安全限制而消失,账号密码也在明文传输。这篇教程带你用 3 种方案完成 wrong-notebook HTTPS 配置,一步到位启用屏幕截图功能,让局域网访问不再"裸奔"。

wrong-notebook 错题本上传页面,包含拍照上传、手动输入与屏幕截图按钮

为什么局域网访问必须配置 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 设置步骤

  1. 地址栏输入 chrome://flags/#unsafely-treat-insecure-origin-as-secure
  2. 在输入框填入你的访问地址(记得带端口),如 http://192.168.1.100:3000
  3. 下拉选择 Enabled,点击 Relaunch 重启浏览器
  4. 刷新页面,屏幕截图按钮就会出现 ✅

Firefox 设置步骤

  1. 地址栏输入 about:config
  2. 搜索 media.devices.insecure.enabled
  3. 设为 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,屏幕截图按钮都会正常显示:

wrong-notebook 数学错题本列表,展示知识点标签与复习状态

使用自定义证书与公网域名部署

如果希望彻底消除"不安全"警告,或者要部署到公网,可以放入自己的证书。把证书放到挂载的 ./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 定时续期并重启容器。

wrong-notebook 错题详情页面,展示题目、知识点标签与举一反三按钮

常见问题快问快答

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 在局域网里既保护了登录凭证,又解锁了屏幕截图录题的完整能力。想深入了解部署细节,可以继续看:

登录后查看全文
wrong-notebook