Remux快速上手：3步用Docker部署你的自托管媒体服务器
Remux快速上手：3步用Docker部署你的自托管媒体服务器
Remux 是一款兼容 Jellyfin API 的自托管媒体服务器（self-hosted media server），它把 Stremio 插件、本地文件、WebDAV 和 BT 种子流式播放整合到同一个媒体库中，并内置了独立的音乐播放管道。无论你使用 Infuse、Swiftfin 还是任何 Jellyfin 客户端，都无需任何改动即可直接接入。下面通过 3 个步骤，用 Docker 快速把 Remux 跑起来。
为什么选择 Remux 作为自托管媒体服务器？
在部署之前，先花一分钟了解 Remux 相比传统媒体服务器的独特之处：
- 🎬 多源媒体库：Stremio 插件、本地文件、WebDAV、Torrent 可以混用在同一个库中
- 📺 Jellyfin 完全兼容：所有现有 Jellyfin 客户端零改动接入
- ⚡ 内置种子直连：无需额外下载工具，直接从种子流式播放
- 🎵 独立音乐管道：音乐不依赖 Stremio，支持独立远程音源
- 📊 内置管理面板：服务器自带 Dashboard，浏览器直接打开即可管理
项目核心由 Rust 编写，主要组件包括 crates/remux-server/（服务端）、crates/remux-dashboard/（管理面板）和 crates/remux-desktop/（桌面端）。
部署前准备：Docker 环境检查
Remux 官方提供 Docker 镜像，部署前请确认：
- 系统已安装 Docker 运行时（Docker Engine 或 Docker Desktop）
- 服务器有可长期持久化的目录，例如
/remux/data，用于存放 SQLite 数据库、日志和种子缓存 - 端口 3000 未被占用（Remux 默认监听 3000）
💡 镜像内已预装 Jellyfin 版 FFmpeg、硬件转码驱动和 yt-dlp，无需额外配置。镜像构建逻辑可以查看 docker/Dockerfile。
第1步：创建 Docker Compose 配置文件
创建 compose.yml（仓库内也附带了开发用的示例配置 docker/compose.yml），内容如下：
version: "3"
services:
remux:
image: ghcr.io/lostb1t/remux:latest
ports:
- "3000:3000"
volumes:
- /remux/data:/data
restart: unless-stopped
关键配置说明：
| 配置项 | 作用 |
|---|---|
image: ghcr.io/lostb1t/remux:latest |
使用官方最新镜像（也可换成 nightly 尝鲜版） |
3000:3000 |
宿主机端口映射，改成 8080:3000 亦可 |
/remux/data:/data |
数据目录挂载，数据库、日志、种子缓存都保存在这里 |
restart: unless-stopped |
容器异常退出后自动拉起 |
第2步：启动容器
在配置文件所在目录执行：
docker compose up -d
确认容器已正常运行：
docker compose ps
docker compose logs -f remux
镜像内置了健康检查，会定期请求 http://127.0.0.1:3000/health。当 ps 中状态显示为 healthy，说明 Remux 自托管媒体服务器已成功启动。
第3步：打开 Web 界面完成初始配置
启动完成后，在浏览器中访问：
- Jellyfin 兼容 API 入口：
http://<服务器IP>:3000 - Remux 管理面板（Dashboard）：
http://<服务器IP>:3000/admin
首次访问会引导你创建管理员账号。之后在管理面板中：
- 添加内容源：导入 Stremio 插件地址，或挂载本地文件库、WebDAV 目录
- 建立媒体库：支持按标签、目录、热度、发行年份等条件动态构建媒体库，无需复制源
- 接入 IPTV（可选）：内置 M3U / XMLTV / Xtream 解析，参考 crates/remux-server/src/iptv/
常见问题排查
🔍 页面无法访问？
docker compose logs remux # 查看日志定位问题
curl http://127.0.0.1:3000/health # 测试健康检查接口
💾 数据会丢吗？
只要挂载了 /remux/data，升级镜像（重新 docker compose up -d）也不会丢失账号、媒体库和播放记录。
📈 如何查看运行日志？
文件日志默认开启，滚动写入 <data_dir>/logs，最多保留 5 个文件。也可通过 Dashboard 的日志页面（需管理员会话）在线查看。
写在最后
到这里，你的 Remux 自托管媒体服务器已经通过 Docker 完整部署成功——3 步、不到 5 分钟。接下来就可以把 Infuse、Swiftfin 等 Jellyfin 客户端指向 http://<服务器IP>:3000，开始享受多源一体的媒体体验了。
更多功能细节（音乐管道、播放跟踪、用户导入等）可以参阅 README.md。