lulalulaluobo/clouddock

•Updated 11 days ago

CloudDock: Quark/Baidu transfers, fnOS NAS downloads, built-in AriaNg. x86-64 Docker Compose.

Image

125

lulalulaluobo/clouddock repository overview

⁠CloudDock

搜索资源或粘贴分享链接，转存夸克 / 百度网盘，再下载到 NAS。夸克使用 aria2，百度使用飞牛官方百度网盘应用；内置 AriaNg 下载进度，支持网盘目录和 NAS 本地目录独立选择。保留资源搜索、搜索频道和频道管理，不依赖 QAS，不创建定时追更任务。

1.1.0 新增链接转存和内置飞牛百度接入：在侧边菜单或手机底部导航进入“链接转存”，粘贴夸克或百度分享文案，自动识别网盘和提取码。解析后复用原有“转存”窗口，勾选资源、选择网盘目录，并按需选择飞牛下载目录。包含手机列表性能优化、CloudDock 品牌统一和百度文件夹下载修复。

镜像：lulalulaluobo/clouddock:1.1.0⁠。架构：linux/amd64（x86-64 NAS），目前未发布原生 ARM64 镜像。生产建议固定具体版本；latest 跟随最新发布。

⁠两个容器，一份 Compose

服务	内容	端口
`app`	CloudDock 后端、网页、内置 AriaNg	宿主机 `7003` → 容器 `8008`
`aria2`	夸克资源下载引擎	`6800` 仅容器内网使用

不需要单独部署 AriaNg，不需要映射 6880 或 RPC 端口。网页自动连接本套 Compose 的 aria2，RPC 密钥留在后端。本地下载及下载管理目前对管理员开放。

百度下载使用同机安装的飞牛官方百度网盘应用，在设置中获取授权后使用；无需增加适配服务。仅使用夸克时部署基础 Compose 即可，百度配置见下方专节。

⁠Docker Compose 部署

在 NAS 创建一个应用目录，把下面的 compose.yaml 和 .env 放进去。飞牛可在 Docker → Compose 中新建项目；命令行也可使用：

mkdir -p /你的应用目录/clouddock
cd /你的应用目录/clouddock
mkdir -p data config logs aria2-config
# 在此目录保存下面的 compose.yaml 和 .env
# 有项目文件时，也可 cp .env.example .env 后修改

⁠1. compose.yaml

name: clouddock
services:
  app:
    image: lulalulaluobo/clouddock:${CLOUDDOCK_VERSION:-1.1.0}
    platform: linux/amd64
    restart: unless-stopped
    ports:
      - "${BIND_IP:-0.0.0.0}:${APP_PORT:-7003}:8008"
    environment:
      TZ: ${TZ:-Asia/Shanghai}
      NODE_ENV: production
      ADMIN_USER_CODE: ${ADMIN_USER_CODE:?请设置 ADMIN_USER_CODE}
      JWT_SECRET: ${JWT_SECRET:-}
      JWT_EXPIRES_IN: ${JWT_EXPIRES_IN:-7d}
      ARIA2_RPC_URL: http://aria2:6800/jsonrpc
      ARIA2_RPC_SECRET: ${ARIA2_RPC_SECRET:?请设置 ARIA2_RPC_SECRET}
      TELE_CHANNELS: ${TELE_CHANNELS:-[]}
      TG_BOT_TOKEN: ""
    volumes:
      - ./data:/app/data
      - ./config:/app/config
      - ./logs:/app/logs
      - ${NAS_DOWNLOAD_PATH:?请设置 NAS_DOWNLOAD_PATH}:/downloads
    depends_on:
      aria2:
        condition: service_started
  aria2:
    image: p3terx/aria2-pro@sha256:086d1a37c586edb07ec0fb956bf9edd89d1d38d138ad5309ff96d510c8c9a011
    platform: linux/amd64
    restart: unless-stopped
    environment:
      TZ: ${TZ:-Asia/Shanghai}
      PUID: ${PUID:-1000}
      PGID: ${PGID:-1001}
      RPC_SECRET: ${ARIA2_RPC_SECRET:?请设置 ARIA2_RPC_SECRET}
      RPC_PORT: "6800"
      UMASK_SET: "022"
      UPDATE_TRACKERS: "false"
      IPV6_MODE: "false"
    volumes:
      - ./aria2-config:/config
      - ${NAS_DOWNLOAD_PATH:?请设置 NAS_DOWNLOAD_PATH}:/downloads

⁠2. .env

复制以下内容，至少修改 NAS_DOWNLOAD_PATH、PUID、PGID、ADMIN_USER_CODE、ARIA2_RPC_SECRET：

CLOUDDOCK_VERSION=1.1.0
BIND_IP=0.0.0.0
APP_PORT=7003
TZ=Asia/Shanghai

# NAS 实际下载目录，必须已存在且下载用户可写
NAS_DOWNLOAD_PATH=/vol3/1000/2T/飞牛影视
PUID=1000
PGID=1001
# 仅启用飞牛百度时使用：官方百度应用登录用户的 UID
BAIDU_NAS_UID=1000

# 自己设置 6～12 位数字，仅用于首次注册管理员，不是登录密码
ADMIN_USER_CODE=把这里改成你自己的数字注册码
# 随机密钥，至少 32 位；建议用下方命令生成 64 位十六进制字符串
ARIA2_RPC_SECRET=把这里改成随机生成的密钥

# 留空自动生成并保存到 config/env，重建容器不会改变
JWT_SECRET=
JWT_EXPIRES_IN=7d
TELE_CHANNELS=[]

生成 RPC 密钥，将输出填入 .env，不要把命令本身填进去：

openssl rand -hex 32

检查下载目录的 UID/GID：

stat -c '%u:%g %n' '/vol3/1000/2T/飞牛影视'

例如输出 1000:1001，就填写 PUID=1000、PGID=1001。目录建议先在 NAS 文件管理器中创建，并确认这个用户可写。不要随意递归修改已有影视库的所有者。下载路径填写宿主机绝对路径，可包含中文和空格，不要填容器路径 /downloads。

⁠3. 启动

docker compose --env-file .env config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 app

访问 http://NAS的IP:7003/。端口被占用时，只改 .env 的 APP_PORT，容器内部端口保持 8008。配置检查使用 --quiet，避免将解析后的密钥打印到终端。

⁠参数说明

参数	是否必填	填写方式
`CLOUDDOCK_VERSION`	否	默认 `1.1.0`；生产固定版本，升级时修改。
`APP_PORT`	否	NAS 上的访问端口，默认 `7003`。
`BIND_IP`	否	默认 `0.0.0.0`，也可绑定 NAS 的指定内网 IP。
`NAS_DOWNLOAD_PATH`	是	NAS 实际下载目录的绝对路径；两个服务共用，必须可写。
`PUID` / `PGID`	按目录填写	aria2 运行用户的数字 UID/GID；按目录所有者填写，不填用户名。
`BAIDU_NAS_UID`	启用百度时填写	在飞牛官方百度应用登录的飞牛用户数字 UID，默认 `1000`；不是百度账号。
`ADMIN_USER_CODE`	是	自选 6～12 位数字，用于注册第一位管理员，不是登录密码；已有管理员后不再用于创建新管理员。
`ARIA2_RPC_SECRET`	是	至少 32 位随机字符串。Compose 自动让两个服务共用，不必在网页填写。
`JWT_SECRET`	否	推荐留空自动生成并持久保存。自定义须至少 32 位，包含大小写字母、数字和特殊字符；修改会让现有登录失效。
`JWT_EXPIRES_IN`	否	登录有效期，默认 `7d`；也可填 `6h`、`30m` 等。
`TZ`	否	默认 `Asia/Shanghai`。
`TELE_CHANNELS`	否	仅空数据库初始化时导入的频道 JSON 数组，默认 `[]`；已有频道时不覆盖。

.env 是 Compose 参数文件；config/env 是 应用配置文件，两者用途不同。JWT 留空时，程序首次启动在后者中保存随机密钥。不要把 NAS Cookie、数据库或密钥写进镜像。

⁠飞牛百度网盘部署

先在同一台飞牛安装官方百度网盘应用并登录。下载目录必须在该应用允许访问的范围内。将下面内容保存为 compose.baidu.yaml，与基础 compose.yaml 放在同一目录：

services:
  app:
    environment:
      BAIDU_NAS_UID: ${BAIDU_NAS_UID:-1000}
      BAIDU_HOST_DOWNLOAD_PATH: ${NAS_DOWNLOAD_PATH:?请设置 NAS_DOWNLOAD_PATH}
    volumes:
      - type: bind
        source: /var/apps/baidu.netdisk/var/db
        target: /run/fnos-baidu/db
        read_only: true
        bind:
          create_host_path: false
      - type: bind
        source: /var/apps/baidu.netdisk/var/ulinks
        target: /run/fnos-baidu/ulinks
        read_only: true
        bind:
          create_host_path: false

.env 填写 BAIDU_NAS_UID 和实际 NAS_DOWNLOAD_PATH 后，使用两份配置启动：

docker compose -f compose.yaml -f compose.baidu.yaml --env-file .env config --quiet
docker compose -f compose.yaml -f compose.baidu.yaml pull
docker compose -f compose.yaml -f compose.baidu.yaml up -d

在飞牛 Docker 的 Compose 编辑器中，也可把这段 environment 和 volumes 合并到基础配置的 app 服务。保持每个服务只有一组 environment 和 volumes。

管理员登录 CloudDock 后，在“设置 → 飞牛百度网盘”点击“获取飞牛百度网盘授权”，确认已连接及会员状态。无需填写百度 Cookie、密码或配对码。切换官方应用账号后重新获取授权。上述两项挂载只读，缺少官方应用目录时不会自动创建空目录。详细说明见飞牛百度接入指南⁠。

⁠首次登录和使用

在登录页选择注册，设置用户名和密码，使用 .env 的 ADMIN_USER_CODE 注册第一位管理员。没有预置账号和密码。
登录后在设置页填写自己的夸克 Cookie 并保存，确认 aria2 显示“已连接”。
全新数据库不携带他人的频道列表。在设置 → 搜索频道中新增/导入自己的频道并保存，或在首次启动前设置 TELE_CHANNELS。
搜索资源，或在“链接转存”粘贴夸克 / 百度分享文案，确认自动识别结果，点击“解析资源”后点“转存”。支持从 URL 或完整文案提取提取码，也可以单独填写。
勾选本次需要的文件/文件夹，点“下一步”。选择网盘保存目录，再在“下载到飞牛”辅助行中更改本地目录，点保存。网盘与飞牛各自有独立的新建文件夹入口。
右上角“下载进度”进入下载管理，夸克任务使用 AriaNg，百度任务查看“百度下载”。百度暂停、继续与失败恢复在飞牛官方应用操作。“返回搜索”回到资源页；“转存记录”处理夸克转存问题和失败重试。

只选择一个文件就只下载该文件；选择整个文件夹则下载内部内容并保留层级。云盘路径与 NAS 路径独立，不自动添加“来自：分享/TV”等网盘前缀。关闭“下载到飞牛”后仅执行原版云盘转存。

频道参数格式，频道用户名一般不带 https://t.me/ 前缀：

TELE_CHANNELS='[{"id":"实际频道用户名","name":"频道名称"}]'

⁠持久化、升级和备份

宿主机目录	用途
`./data`	SQLite 数据库：账号、Cookie、频道和转存作业等。
`./config`	JWT 签名密钥与应用配置。
`./aria2-config`	aria2 配置和下载会话。
`./logs`	应用日志。
`NAS_DOWNLOAD_PATH`	实际下载文件。

备份 .env、data、config、aria2-config。为保证备份一致，可先 docker compose stop，复制这些文件和目录后再 docker compose start。

升级时修改 .env 中的固定版本，再运行：

docker compose pull app
docker compose up -d app
docker compose ps

这不会重建 aria2 或删除下载文件。回滚时恢复上一个固定版本；未来若有数据库结构升级，需恢复对应备份。不要用 docker compose down -v 清理生产数据。

启用百度的部署，后续检查、升级、重建、备份前停止和启动，都必须继续带 -f compose.yaml -f compose.baidu.yaml，否则会丢失百度所需的挂载和环境参数。例如升级：

docker compose -f compose.yaml -f compose.baidu.yaml pull app
docker compose -f compose.yaml -f compose.baidu.yaml up -d --no-deps app

⁠从 NAS 测试版迁移

复用原 data/config/logs/aria2-config、媒体目录和 RPC 密钥，即可保留账号、频道及已完成任务。不要在空目录启动后误以为数据丢失。旧 deploy/compose.yaml 是 NAS 分发文件挂载测试方案；正式镜像使用本 README 的根目录 compose.yaml，不再需要 RELEASE_PATH、native 或 web 源码挂载。发布镜像不会自动切换当前 NAS 服务。

⁠常见问题

aria2 未连接：确认两服务都在运行且 ARIA2_RPC_SECRET 共用同一个值。Compose 中 RPC 地址是 http://aria2:6800/jsonrpc，不要改成 localhost。
下载无权限：检查实际目录与 UID/GID。两服务内部都应挂载到 /downloads。
登录失效：重新登录；不要每次重建容器都换 JWT 密钥或清空 config。
搜索无资源：配置搜索频道，或直接解析分享链接；需要代理时在原设置页配置。
下载失败：先看“转存记录”。Cookie/下载直链失效时从那里重试；AriaNg 管理已有下载，顶部“新建”返回 CloudDock 搜索入口。

⁠开发和来源

1.1.0 包含内置飞牛百度授权、转存和下载，以及夸克 / 百度自动识别的“链接转存”入口。测试方式见 TESTING.md⁠ 和链接转存指南⁠。

python3 scripts/prepare-web.py
node --test tests/web.test.cjs tests/share-link.test.cjs tests/baidu-native.test.cjs tests/visibility.test.cjs
docker build --platform linux/amd64 --build-arg CLOUDDOCK_VERSION=1.1.0 -t lulalulaluobo/clouddock:1.1.0 .

upstream/nas-v0.8.3 是 NAS 镜像的混淆后端和编译前端，不包含原始 TypeScript/Vue 源码。本项目通过经过版本校验的接入点扩展，不使用早期 v0.2.5 源码重建页面。Docker 构建复用固定 digest 的 NAS v0.8.3 基础镜像，不额外安装应用依赖；构建上下文不含用户配置、数据和凭据。

感谢 CloudSaver⁠、AriaNg⁠、aria2⁠ 和 aria2-pro⁠。AriaNg 许可证随静态资源保留。功能验收见 TESTING.md⁠。

Tag summary

Recent tags

Content type

Image

Digest

sha256:fe23e36f3…

Size

67.8 MB

Last updated

11 days ago

docker pull lulalulaluobo/clouddock