远程访问与手机 App

Rerinku View 运行在你自己的机器上。在家里的局域网里，用浏览器打开它的地址就能用；出门在外时，有两种方式：在 Rerinku View 里开启快速连接，或者自己用反向代理、VPN 把它暴露出去。

局域网访问

首次启动时，Rerinku View 会在工作目录生成 config.yaml，默认监听 0.0.0.0:8080，同一网络里的设备用 http://<机器 IP>:8080 就能打开控制台。Docker 镜像同样监听所有地址的 8080 端口。

只想在本机使用时，把监听地址改成 127.0.0.1:8080（环境变量 HTTP_ADDR，或配置文件里的对应项）。

局域网里的任何人都能打开控制台。 没设访问密码时，同一网络的设备无需登录就能使用控制台，也能直接绑定手机。要挡住别人，请设置访问密码。

快速连接

快速连接让你在任何地方通过一个固定的 HTTPS 地址打开自己的 Rerinku View，不需要公网 IP、不需要改路由器。

1. 打开 设置 → 快速连接 → 远程访问，点「连接 Rerinku Cloud」。
2. 浏览器跳到 rerinku.com，登录（没有账号先注册）并授权这台 Rerinku View。你的密码不会经过 Rerinku View。
3. 授权后自动回到控制台，页面上显示这台 Rerinku View 的公网地址，形如 https://n1234….nodes.rerinku.com。

它是怎么工作的：

• Rerinku View 主动向 Rerinku Cloud 建立一条出站加密隧道，外面的请求经 Cloud 网关转进来。网关负责 HTTPS，所以控制台页面、接口、回放和缩略图的内容会经过网关。
• 实时画面不走隧道。 实时画面用 WebRTC 在你的浏览器和 Rerinku View 之间直接传输（DTLS-SRTP 加密）；两边直连不通时，经 Rerinku Cloud 的 TURN 中继转发。
• 公网地址本身就是入口：拿到地址的人就能打开你的控制台。开启快速连接时，请务必设置访问密码。

管理：

• 「启用快速连接」开关可以暂时停用，配置保留，随时再打开。
• 「断开并移除」会通知 Rerinku Cloud 释放这个节点，并删除本机的连接信息。Cloud 暂时连不上时也会照常删除，并提示你去 Cloud 控制台手动移除。
• 在 Rerinku Cloud 控制台里撤销某台 Rerinku View 后，它会停在「已撤销」状态，需要先「断开并移除」，再重新连接。

不想用 Cloud 的话，可以自己用反向代理（Nginx、Caddy 等）或 VPN（WireGuard、Tailscale 等）把 Rerinku View 暴露出去。经反向代理访问时，请设置 TRUST_PROXY_HEADERS=true，让 Rerinku View 识别真实的客户端地址和 HTTPS。

Rerinku View 手机 App

Rerinku View 的安卓 App 用来在手机上看画面、看事件、收通知，需要 Android 7.0 或更高。到下载页安装。

配对：

1. 在控制台打开 设置 → 快速连接 → 手机 App，页面上会显示一个二维码。
2. 在 App 里扫这个二维码，确认后即完成绑定。二维码里只有 Rerinku View 的地址，没有密码；绑定后 App 拿到一个长期有效的令牌。
3. 已绑定的手机列在同一页的「已绑定的手机」里，可以随时「解除绑定」。

二维码列出的地址是你当前打开控制台的地址和这台机器的局域网 IP，不包含快速连接地址。在外面也要用 App 的话，请在 App 里把服务器地址改成快速连接地址。每台服务器在 App 里只保存一个地址，不会在局域网和快速连接之间自动切换。

App 能做什么：

• 设备：实时画面，可以切换清晰度、开关声音、全屏、截图，以及把一段录像存到手机相册；画面下方是这台摄像头最近的事件。
• 事件：按全部、人员、人脸、报警输入筛选；事件详情里有标出目标的截图和事件录像。
• 通知：有新事件时推送到手机，点开直接进入对应的实时画面或事件详情。

目前 App 还不支持时间轴回放、云台和对讲；iOS 版还没有上架。

设了访问密码的 Rerinku View，当前版本的 App 无法绑定（App 还没有密码输入框）。已经绑定的手机不受影响。

推送通知

手机通知由 Rerinku View 决定发什么、发给谁，并按手机的语言拼好文案，再经 rerinku.com 的推送中继转给手机。中继不需要账号，也不需要开启快速连接，只要 Rerinku View 能访问互联网。通知里的图片不经过中继：手机收到通知后，凭自己的令牌回 Rerinku View 取图。

通知总开关和规则在 设置 → 通知 里，见事件与通知。

访问密码

访问密码是挡住其他人的方法，在 设置 → 会话 → 访问密码 里设置，至少 8 个字符。

设了访问密码之后：

• 所有浏览器都要先登录，包括在本机打开、以及经快速连接访问的情况。登录状态保持 30 天，期间有访问会自动续期。
• 修改或移除密码时，所有浏览器的登录都会失效；已经绑定的手机和 Home Assistant 不受影响。
• 新的绑定必须提供密码。连续输错会被限速。
• 没设访问密码、而 Rerinku View 又能从外部访问（监听了局域网地址，或开着快速连接）时，控制台顶部会有一条提示。

忘记密码： 设置环境变量 RESET_ACCESS_PASSWORD=1 启动一次 Rerinku View，密码会被清除；之后务必去掉这个变量再重启。

已授权的设备和应用

在哪里	管理什么
设置 → 快速连接 → 手机 App →「已绑定的手机」	手机和 Home Assistant
设置 → 开发者 →「已授权的应用」	第三方程序和只读查看令牌，见开放接口

撤销后，对方的请求会被拒绝。注意：没设访问密码时，解除绑定只是「断开」，对方重新扫码就能再绑定。

哪些数据会离开这台机器

什么时候	发往哪里	内容
始终（默认开启）	Rerinku Cloud	每 10 分钟一次安装信息：实例 ID、版本、操作系统和硬件概况。设 CLOUD_REPORT=false 关闭
有通知要发时	推送中继	设备名、事件类别（认出熟人时包括人名）、推送令牌和相关 ID；不含图片
开启快速连接后	Rerinku Cloud 网关	经快速连接地址访问时的全部 HTTP 内容（页面、接口、回放、缩略图）

摄像头画面、录像和识别结果默认都保存在本机。详见隐私政策。