基础教程

ZViewer 是多人同步观影、追番与远程共享平台。本章节为基础教程，大部分人使用这部分即可；项目详细信息见拓展教程。

快速上手

1. 下载

从 Releases 下载对应系统的压缩包（Windows zviewer-windows-x64.zip / Linux zviewer-linux-x64.tar.gz），解压后运行。

2. 启动

# Windows
start.bat start #也可以直接双击start.bat文件

# Linux
./start.sh start

3. 登录

访问 http://localhost:3333。首次启动自动创建超级管理员：

用户名	密码
root	root

生产环境部署后应立即修改默认密码（右上角用户菜单 → 个人资料 → 编辑信息 → 修改密码）。

4. 创建房间

点击「开始共享」→ 选择模式（一起看 / 投屏）→ 进入房间。将房间信息面板中的房间号或分享链接发给其他用户，对方可通过房间号、房间列表或链接加入。

5. 添加影片

在「添加影片」面板选择来源：B站（粘贴 BV 号或链接解析）、直链（MP4 等地址）、WebDAV / FTP / OpenList 挂载（先在个人资料页或后台配置）。点击影片开始播放，进度实时同步给所有成员。

端口

端口	用途	对外
3333	统一入口：API、WebSocket、前端页面、/live FLV 代理	是
3334	RTMP 推流（OBS）	是
3335	HTTP-FLV 拉流（内部）	否

浏览器要求

使用内核 130+ 的 Chromium 浏览器（Chrome / Edge 等）。Safari 与 Firefox 对 MSE / MKV 解码支持不完整，可能出现卡顿、无法解码、字幕异常。

本分区目录

页面	内容
安装与部署	单文件 / 源码 / Docker / 数据持久化
功能说明	全部功能的使用说明
手机端 App	Android / HarmonyOS 客户端下载、安装与平台差异
ZViewerCLI	本地代理客户端安装与使用
管理后台	用户审核、房间管理、系统设置
网络连接与内网穿透	FRP / ZeroTier / IPv6
常见问题	证书、WebSocket、数据库等常见问题

需要 HTTPS 时，用一键脚本签发并启动（start.bat https / ./start.sh https）；证书签发机制与实现细节见 HTTPS 证书。（新手建议使用内网穿透的自动https或者配一个本地证书的就可以了，本地证书虽然会弹一个警告，但是无妨）

相关页面：拓展教程