cs920/happy-capy

By cs920

•Updated 2 days ago

CapyPlayer 可扩展 Backend Runtime，Docker 一键部署

Image

10K+

Overview Tags

cs920/happy-capy repository overview

⁠Happy Capy

给你的 CapyPlayer 加上影视源，只要跑一个容器。

⁠🎬 这是什么

+--------------+     +--------------+     +--------------+
|    .---.     |     |     ___      |     |    .---.     |
|    | > |     |  +  |    |___|     |  =  |    |^_^|     |
|    '---'     |     |    |___|     |     |    '---'     |
|  CapyPlayer  |     |  Happy Capy  |     |  　快乐观影　  |
+--------------+     +--------------+     +--------------+
手机/pad/电脑上的卡皮     happy-capy           想看的都能看

不限平台，也不限片源。

手机、平板、电脑，装了 CapyPlayer 就能用；短剧、漫剧、榜单、番剧，翻不到底。

想看就看。

⁠🚀 这怎么玩

要做的就三件事

1️⃣ 装上容器 ➡️ 2️⃣ 打开导航页 ➡️ 3️⃣ 装进 CapyPlayer

⁠1️⃣ 用 Docker 装上 happy-capy

方式一：一行命令

docker run -d \
  --name happy-capy \
  --restart unless-stopped \
  -p 8788:8788 \
  -v ./data:/data \
  cs920/happy-capy:latest

方式二：Docker Compose ✅

长期挂着跑就用这个 —— NAS、个人服务器、云主机都行，升级和改配置都更省事：

services:
  happy-capy:
    image: cs920/happy-capy:latest
    container_name: happy-capy
    restart: unless-stopped
    ports:
      - "8788:8788"
    volumes:
      - ./data:/data

docker compose up -d

⁠🔒 权限管理（可选，公网暴露推荐）

默认处于内网免密模式（无需配置），任何人连上端口均可直接看剧。

如果你通过公网、DDNS、端口转发或反向代理暴露服务，建议开启权限管理：

Docker Compose 配置：

services:
  happy-capy:
    image: cs920/happy-capy:latest
    container_name: happy-capy
    restart: unless-stopped
    ports:
      - "8788:8788"
    environment:
      - AUTH_ENABLED=true               # 鉴权总开关（开启后下面两项必填）
      - ADMIN_TOKEN=你的管理员令牌      # 控制组件管理、安装/卸载组件、全服诊断
      - TOKEN=你的客户端看剧令牌        # 控制短剧 API 与组件下载
    volumes:
      - ./data:/data

Docker Run 命令配置：

docker run -d \
  --name happy-capy \
  --restart unless-stopped \
  -p 8788:8788 \
  -e AUTH_ENABLED=true \
  -e ADMIN_TOKEN=你的管理员令牌 \
  -e TOKEN=你的客户端看剧令牌 \
  -v ./data:/data \
  cs920/happy-capy:latest

⁠权限模式与访问效果对比

访问地址	身份角色	组件“复制 URL”效果	组件仓库（安装/更新/卸载）	服务器链路诊断
`http://<服务器地址>:8788`	匿名访客	复制时弹窗提示输入 TOKEN	❌ 弹窗拦截，需要 ADMIN_TOKEN	❌ 弹窗拦截，需要 ADMIN_TOKEN
`http://<服务器地址>:8788/?token=TOKEN`	受邀看剧访客	✅ 自动带 Token，一键复制直接看剧	❌ 弹窗拦截，需要 ADMIN_TOKEN	❌ 弹窗拦截，需要 ADMIN_TOKEN
`http://<服务器地址>:8788/?token=ADMIN_TOKEN`	超级管理员	✅ 自动带 Token	✅ 完全解锁，自由管理组件	✅ 完全解锁，自由发起诊断

⁠🌐 网络与代理（可选）

💡 绝大多数用户无需配置代理：

标记为 服务器直连 或 手机端直连 的组件，国内网络均可直接畅快使用；

只有个别海外源卡片标记为 建议海外代理 且你所在的网络环境无法直连时，才需要按需配置局部代理。

⁠徽章说明

首页卡片会展示组件的网络模式（仅展示脱敏状态，绝不泄露任何代理 IP 或密码）：

服务器直连：容器服务器直连源站，无需代理；
手机端直连：由播放器手机客户端直接拉取媒体流，不占用你的服务器流量；
建议海外代理 / 海外代理已配置：受海外源站网络限制，提示可为其挂载局部代理。

⁠局部代理配置方法（仅需两步）

推荐仅为需要的组件单独指定代理，避免让整个容器全局走代理影响国内速度：

⁠第一步：在同级目录下创建 `config.toml`

新建文本文件 config.toml，填入需要代理的组件标识与你的代理地址：

[providers.<组件ID>]
enabled = true
# 填写你实际可用的 HTTP(S) 代理：
proxy = "http://192.168.1.100:7890"

📌 常见代理地址填写参考：

软路由 / 旁路由代理：填路由器的局域网 IP，如 http://192.168.1.1:7890；

宿主机本地代理客户端（Clash / v2rayA 等）：填宿主机局域网 IP 或 http://host.docker.internal:7890（⚠️ 千万别填 127.0.0.1，容器里的 127.0.0.1 指的是容器自己）；

代理也是 Docker 容器：若代理与本容器在同一个 Docker 网络下，直接填代理容器名，如 http://clash:7890。

⁠第二步：挂载文件并启动容器

使用 Docker Compose：在 volumes 中增加一行挂载，然后执行 docker compose up -d：
```
volumes:
  - ./data:/data
  - ./config.toml:/config/config.toml:ro   # 挂载代理配置文件
```
使用 Docker Run：在运行命令中加入挂载参数即可：
```
-v ./config.toml:/config/config.toml:ro
```

🔄 配置生效与更新：后续若修改了 config.toml 中的代理地址，只需执行 docker restart happy-capy 即可重载配置，无需重新创建容器。

⁠2️⃣ 打开导航页

http://<你的服务器地址>:8788/

导航页会显示运行状态和组件地址。若开启了权限管理，管理员请通过 http://<你的服务器地址>:8788/?token=<ADMIN_TOKEN> 访问以解锁管理后台。

⁠3️⃣ 在 CapyPlayer 里装组件

在刚打开的导航页，想看哪个复制哪个。

再到 CapyPlayer 的 设置 ➡️ 组件，点右上角的 ➕ 添加。

组件会跟着你这次访问用的地址走：用局域网地址复制的，就只能局域网访问；用公网地址复制的，在外面也能访问。

想在外面也能看，就用公网地址打开一次导航页再复制。

⁠💬 交流与反馈

Telegram 交流群：https://t.me/+RCXl7EhDndA2MmVl⁠

⁠免责声明

本项目只是一个技术工具：不存储、不托管、不提供任何影视内容，内容均来自第三方，本项目对其合法性、准确性或可用性不作任何保证。

请在你所在国家/地区法律允许的范围内使用，并自行承担全部责任。
请勿用于任何侵犯著作权或其他合法权益的用途。
与任何第三方平台、应用（包括文中提到的播放器与内容来源）均无隶属、合作或背书关系，相关名称与商标归各自权利人所有。
软件按「现状」提供，不提供任何明示或默示担保；因使用或无法使用本软件造成的任何损失，作者不承担任何责任。

Tag summary

Recent tags

Content type