如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png
LinuxServer.io团队提供的此容器具有以下特点:
https://github.com/samcm/synclounge%E6%98%AF%E4%B8%80%E6%AC%BE%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%85%81%E8%AE%B8%E6%82%A8%E4%B8%8E%E6%9C%8B%E5%8F%8B/%E5%AE%B6%E4%BA%BA%E5%90%8C%E6%AD%A5%E8%A7%82%E7%9C%8BPlex%E5%86%85%E5%AE%B9%EF%BC%8C%E6%97%A0%E8%AE%BA%E6%82%A8%E8%BA%AB%E5%9C%A8%E4%BD%95%E5%A4%84%E3%80%82
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/synclounge-banner.png
我们利用Docker清单实现多平台支持。有关更多信息,请参见Docker的https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list%E5%92%8C%E6%88%91%E4%BB%AC%E7%9A%84%E5%85%AC%E5%91%8A%E3%80%82
只需拉取lscr.io/linuxserver/synclounge:latest即可获取适合您架构的正确镜像,您也可以通过标签拉取特定架构的镜像。
此镜像支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<版本标签> |
| arm64 | ✅ | arm64v8-<版本标签> |
Web应用和服务器均可通过http://SERVERIP:8088访问。
注意:建议使用http作为外部协议并配合反向代理,因为https可能与外部Plex客户端不兼容。
此镜像可在只读容器文件系统下运行。有关详细信息,请阅读文档。
此镜像可使用非root用户运行。有关详细信息,请阅读文档。
以下提供docker-compose和docker cli两种方式帮助您创建容器。
[!NOTE] 除非参数标记为"可选",否则均为必填项,必须提供值。
yaml--- services: synclounge: image: lscr.io/linuxserver/synclounge:latest container_name: synclounge environment: - AUTH_LIST=plexuser1,plexuser2,email1,machineid1 #可选 ports: - 8088:8088 restart: unless-stopped
bashdocker run -d \ --name=synclounge \ -e AUTH_LIST=plexuser1,plexuser2,email1,machineid1 `#可选` \ -p 8088:8088 \ --restart unless-stopped \ lscr.io/linuxserver/synclounge:latest
容器通过运行时传递的参数进行配置(如上所示)。这些参数以冒号分隔,表示<外部>:<内部>。例如,-p 8080:80表示将容器内的80端口映射到主机的8080端口,供外部访问。
| 参数 | 功能 |
|---|---|
-p 8088:8088 | Web应用和服务器端口 |
-e AUTH_LIST=plexuser1,plexuser2,email1,machineid1 | 若设置,只有此处定义的用户和Plex服务器用户可访问服务器。使用电子邮件、Plex用户名和/或Plex服务器机器ID,用逗号分隔,无空格。 |
--read-only=true | 以只读文件系统运行容器。请阅读文档。 |
--user=1000:1000 | 以非root用户运行容器。请阅读文档。 |
您可以使用特殊前缀FILE__从文件中设置任何环境变量。
例如:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
这将根据/run/secrets/mysecretvariable文件的内容设置环境变量MYVAR。
我们的所有镜像都支持通过可选的-e UMASK=022设置覆盖容器内服务的默认umask值。请注意,umask不是chmod,它基于其值减少权限而非增加。有关详细信息,请阅读此处。
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=synclounge&query=%24.mods%5B%27synclounge%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看可用的通用mods")
我们发布了各种https://github.com/linuxserver/docker-mods%E4%BB%A5%E5%90%AF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E5%8F%AF%E8%AE%BF%E9%97%AE%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84Mods%E5%88%97%E8%A1%A8%EF%BC%88%E5%A6%82%E6%9C%89%EF%BC%89%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%BA%94%E7%94%A8%E4%BA%8E%E4%BB%BB%E4%BD%95LinuxServer.io%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8Mods%E3%80%82
容器运行时的Shell访问:
bashdocker exec -it synclounge /bin/bash
实时监控容器日志:
bashdocker logs -f synclounge
容器版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' synclounge
镜像版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/synclounge:latest
我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器才能更新内部应用。除了相关readme.md中特别说明的情况外,我们不建议或支持在容器内更新应用。请参考上方的应用设置部分,了解是否推荐对此镜像进行应用更新。
以下是更新容器的说明:
更新镜像:
所有镜像:
bashdocker-compose pull
单个镜像:
bashdocker-compose pull synclounge
更新容器:
所有容器:
bashdocker-compose up -d
单个容器:
bashdocker-compose up -d synclounge
您还可以删除旧的悬空镜像:
bashdocker image prune
更新镜像:
bashdocker pull lscr.io/linuxserver/synclounge:latest
停止运行中的容器:
bashdocker stop synclounge
删除容器:
bashdocker rm synclounge
使用上述相同的docker run参数重新创建新容器(如果正确映射到主机文件夹,您的/config文件夹和设置将被保留)
您还可以删除旧的悬空镜像:
bashdocker image prune
[!TIP] 我们推荐使用Diun获取更新通知。不建议或支持使用其他自动更新容器的工具。
如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑:
bashgit clone https://github.com/linuxserver/docker-synclounge.git cd docker-synclounge docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/synclounge:latest .
ARM变体可以在x86_64硬件上构建,反之亦然,使用lscr.io/linuxserver/qemu-static:
bashdocker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
注册后,您可以使用-f Dockerfile.aarch64指定要使用的dockerfile。
AUTOJOIN_ENABLED和AUTOJOIN_ROOM选项。EXTERNAL_URL、EXTERNAL_SERVER_PORT和AUTOJOIN_PASSWORD已弃用且不再生效。环境变量AUTOJOIN_ENABLED和AUTOJOIN_ROOM仍可使用,但未来将被Synclounge内置变量autojoin__room取代。如果使用反向代理,请不要忘记更新代理设置(https://github.com/linuxserver/reverse-proxy-confs/blob/master/synclounge.subdomain.conf.sample%E5%92%8Chttps://github.com/linuxserver/reverse-proxy-confs/blob/master/synclounge.subfolder.conf.sample%EF%BC%89%EF%BC%8C%E5%9B%A0%E4%B8%BA%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%AB%AF%E5%8F%A3%E5%92%8C%E5%9C%B0%E5%9D%80%E5%B7%B2%E6%9B%B4%E6%94%B9%E3%80%826aecc9bd,同时评估上游的破坏性变更。您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务