文档目录
安装 Rerinku View
先在安装前准备里确认平台、摄像头和存储,再选择下面的安装方式。已经能打开控制台的用户,可以直接进入快速开始。
发布准备中: Docker 镜像
rerinku/view已发布,可以直接使用;Linux、macOS、Windows 安装包的下载地址和文件名仍是发布占位,请以下载页的发布状态为准,在正式发布前下面的下载命令不能使用。
安装
提供 x86-64 和 ARM64 两种压缩包。下载并安装(ARM64 机器把 amd64 换成 arm64):
curl -LO https://download.rerinku.com/onboard/rerinku-view_linux_amd64.tar.gz
tar -xzf rerinku-view_linux_amd64.tar.gz
sudo install -m 755 rerinkuview /usr/local/bin/先在前台运行一次。Rerinku View 会在当前目录生成配置文件 config.yaml 和数据目录 data/:
mkdir -p ~/rerinku && cd ~/rerinku
rerinkuview用浏览器打开 http://<机器 IP>:8080,能看到控制台就成功了。确认没问题后按 Ctrl+C 停止,改成 systemd 服务长期运行:
sudo useradd -r -s /usr/sbin/nologin rerinku
sudo mkdir -p /var/lib/rerinku-view
sudo chown rerinku: /var/lib/rerinku-view# /etc/systemd/system/rerinku-view.service
[Unit]
Description=Rerinku View
After=network-online.target
Wants=network-online.target
[Service]
User=rerinku
# 配置文件 config.yaml 和数据目录 data/ 都放在这里
WorkingDirectory=/var/lib/rerinku-view
Environment=RERINKU_BIN_DIR=/var/lib/rerinku-view/bin
ExecStart=/usr/local/bin/rerinkuview
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now rerinku-view要接 USB 摄像头,或用显卡做 AI 识别的硬件解码,把运行用户加进对应的组:sudo usermod -aG video,render rerinku,然后重启服务。
提供 Apple 芯片(arm64)和 Intel(amd64)两种压缩包。下载并解压(Intel 机器把 arm64 换成 amd64):
curl -LO https://download.rerinku.com/onboard/rerinku-view_darwin_arm64.tar.gz
tar -xzf rerinku-view_darwin_arm64.tar.gz从浏览器下载的可执行文件会被 Gatekeeper 拦下,先去掉隔离标记:
xattr -d com.apple.quarantine ./rerinkuview运行。Rerinku View 会在当前目录生成 config.yaml 和 data/:
mkdir -p ~/rerinku
cp ./rerinkuview ~/rerinku/
cd ~/rerinku
./rerinkuview需要开机自启的话,写一个 launchd 的 LaunchAgent(放在 ~/Library/LaunchAgents/,WorkingDirectory 设为上面的目录,RunAtLoad 设为 true)。macOS 上不支持 USB 摄像头。
提供 x64 和 ARM64 两种 zip 包。下载 rerinku-view_windows_amd64.zip(ARM64 机器选 rerinku-view_windows_arm64.zip),解压后在 PowerShell 里运行:
Expand-Archive rerinku-view_windows_amd64.zip -DestinationPath C:\rerinku-view
cd C:\rerinku-view
.\rerinkuview.exe首次运行时 Windows 防火墙会弹窗,请允许「专用网络」访问,否则局域网里的设备连不上。需要随系统启动的话,可以用任务计划程序(触发器选「启动时」,起始位置设为 C:\rerinku-view),或用 NSSM 一类的工具注册为服务。Windows 上不支持 USB 摄像头。
Docker 镜像提供 x86-64(amd64)和 ARM64 两种架构,Docker 会自动拉取与你机器匹配的那一个。已内置 AI 识别组件和 AMD 显卡的解码驱动;Intel 显卡的解码驱动只在 x86-64 镜像里。
docker run -d --name rerinku-view \
--network host \
--restart unless-stopped \
-v rerinku-view-data:/data \
rerinku/view:latest推荐 --network host:ONVIF 自动发现依赖组播,WebRTC 需要动态端口。macOS 和 Windows 上的 Docker Desktop 运行在虚拟机里,无法自动发现摄像头,这两个平台建议用原生安装。
长期运行建议用 Compose:
下面的 Compose 示例使用当前目录下的 data/。首次部署时先创建目录,并给容器的运行用户(UID 65532)写入权限:
mkdir -p data
sudo chown 65532:65532 data# compose.yaml
services:
rerinku-view:
image: rerinku/view:latest
container_name: rerinku-view
network_mode: host
restart: unless-stopped
volumes:
- ./data:/data
# 用 Intel / AMD 显卡做硬件解码、直连 USB 摄像头时取消注释:
# devices:
# - /dev/dri:/dev/dri
# - /dev/video0:/dev/video0docker compose up -d镜像里的数据都在 /data 卷中,升级时拉新镜像后重建容器即可:docker compose pull && docker compose up -d。
首次启动会对局域网开放三个端口:控制台 8080、设备接入用的 MQTT 1883,以及国标 SIP 5060。国标平台默认开启,注册密码是
change-me:不用国标的话,在 设置 → 国标接入 里关掉;要用就先改掉密码。见配置参考。
检查服务是否正常:
curl http://127.0.0.1:8080/healthz
安装后
浏览器能打开控制台、/healthz 返回正常后,继续快速开始,接入第一台摄像头并验证录像。服务启动失败或其他机器打不开控制台时,见故障排查。