# CHY-TV+CHY免费域名注册平台

**Repository Path**: CHYbenzun666/chy

## Basic Information

- **Project Name**: CHY-TV+CHY免费域名注册平台
- **Description**: CHY网站wed端666
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 6
- **Created**: 2026-01-11
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!-- markdownlint-disable MD033 MD026 MD034 -->

# CHY-TV

<div align="center">
  <img src="public/favicon.ico" alt="CHY-TV Logo" width="120">
</div>

> 🎬 **CHY-TV** 是一个现代化的开源影视聚合播放平台。基于 **Next.js 16** + **React 19** + **Tailwind CSS 4** 构建，提供多源聚合搜索、在线播放、弹幕系统、收藏同步、播放记录等核心功能，支持 Docker 部署和多种存储后端。

<div align="center">

![Next.js](https://img.shields.io/badge/Next.js-16-black?logo=nextdotjs)
![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)
![TailwindCSS](https://img.shields.io/badge/TailwindCSS-4-38bdf8?logo=tailwindcss)
![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript)
![License](https://img.shields.io/badge/License-MIT-green)
![Docker](https://img.shields.io/badge/Docker-ready-blue?logo=docker)
![Version](https://img.shields.io/badge/Version-1.3.0-orange)

</div>

## 🤩 在线体验

[点击访问](https://xn--chy-js0fk50c.top/)

## ✨ 核心功能

- 🔍 **智能聚合搜索** - 一站式搜索多个影视源，支持豆瓣评分显示
- ▶️ **流畅在线播放** - 集成 HLS.js & ArtPlayer 5.3 播放器，支持多种视频格式
- 💬 **弹幕系统** - 支持弹幕显示、发送、暂停悬停，智能滚动速度
- ❤️ **收藏与同步** - 支持 Kvrocks/Redis/Upstash/Turso 多种存储后端
- 👤 **用户管理系统** - 支持注册、登录、权限控制、观看历史
- 📱 **响应式设计** - 完美适配桌面端和移动端，支持全屏播放
- 🌗 **主题切换** - 支持明暗双主题模式，自动跟随系统
- 🛡️ **内容过滤** - 智能成人内容识别与过滤
- 📦 **Docker 部署** - 一键部署，支持多种环境
- 🔗 **多客户端支持** - 支持 OrionTV、TVBox 等客户端

## 🛠 技术架构

| 类别     | 技术栈                                                                                                |
| -------- | ----------------------------------------------------------------------------------------------------- |
| 前端框架 | [Next.js 16](https://nextjs.org/) (App Router)                                                        |
| 渲染引擎 | React 19 + Turbopack                                                                                  |
| 样式系统 | [Tailwind CSS 4](https://tailwindcss.com/)                                                            |
| 编程语言 | TypeScript 5                                                                                          |
| 播放器   | [ArtPlayer](https://github.com/zhw2590582/ArtPlayer) + [HLS.js](https://github.com/video-dev/hls.js/) |
| 状态管理 | React Context + Hooks                                                                                 |
| 代码质量 | ESLint 9 + Prettier 3 + Jest 29                                                                       |

## 📝 更新日志

### v1.3.0 (2026-02-15)

#### ✨ 新功能

- 🎬 **弹幕系统重构** - 全新的弹幕显示引擎，支持暂停悬停交互
  - 鼠标悬停弹幕时自动停止滚动
  - 悬停时显示视觉反馈（放大、背景高亮）
  - 全屏模式下弹幕正常显示
- 🔧 **播放器控制栏优化** - 新增弹幕开关按钮
- 📄 **ICP备案支持** - 支持通过环境变量配置备案信息

#### 🐛 Bug修复

- 修复弹幕暂停后继续播放时消失的问题
- 修复全屏模式下弹幕不显示的问题
- 修复 Upstash 环境变量解析问题
- 修复构建时 Upstash 客户端初始化错误

#### 🔨 优化

- 延迟初始化 Upstash 客户端，避免构建时错误
- 优化弹幕滚动性能，减少不必要的重渲染
- 移除推荐系统，简化代码结构

### v1.2.0 (2026-02-10)

#### ✨ 新功能

- 💬 **弹幕系统基础功能** - 支持弹幕显示和发送
  - 智能弹幕滚动速度，根据弹幕长度自动调整
  - 弹幕颜色选择器，支持多种预设颜色
  - 弹幕输入框，支持发送实时弹幕

#### 🔨 优化

- 优化播放器性能，提升视频加载速度
- 改进用户界面细节体验

#### 🐛 Bug修复

- 修复已知问题，提升系统稳定性

### v1.1.0

- 新增多存储后端支持（Upstash、Turso）
- 优化用户界面
- 修复已知问题

### v1.0.0

- 🎉 首次发布
- 基础影视搜索和播放功能
- 用户系统和收藏功能
- Docker 部署支持

## 🚀 快速部署

### Docker 部署（推荐）

```bash
# 拉取最新镜像
docker pull ghcr.io/decohererk/CHY-TV:latest

# 使用 Kvrocks 存储（推荐）
docker run -d \
  --name chy-tv \
  -p 3000:3000 \
  -e USERNAME=admin \
  -e PASSWORD=your_password \
  -e NEXT_PUBLIC_STORAGE_TYPE=kvrocks \
  -e KVROCKS_URL=redis://kvrocks-host:6666 \
  ghcr.io/decohererk/CHY-TV:latest
```

### Docker Compose 部署

```yaml
version: '3.8'
services:
  chy-tv:
    image: ghcr.io/decohererk/CHY-TV:latest
    container_name: chy-tv
    ports:
      - '3000:3000'
    environment:
      - USERNAME=admin
      - PASSWORD=your_password
      - NEXT_PUBLIC_STORAGE_TYPE=redis
      - REDIS_URL=redis://redis:6379
    depends_on:
      - redis

  redis:
    image: redis:alpine
    container_name: chy-tv-redis
    volumes:
      - redis-data:/data

volumes:
  redis-data:
```

## ⚙️ 环境配置

### 基础配置

| 环境变量                | 说明         | 示例                      |
| ----------------------- | ------------ | ------------------------- |
| `USERNAME`              | 管理员用户名 | `admin`                   |
| `PASSWORD`              | 管理员密码   | `your_secure_password`    |
| `SITE_BASE`             | 站点基础URL  | `https://your-domain.com` |
| `NEXT_PUBLIC_SITE_NAME` | 站点名称     | `CHY-TV`                  |
| `NEXT_PUBLIC_YIBEIAN`   | ICP备案号    | `京ICP备XXXXXXXX号`       |

### 存储配置

```bash
# Redis 存储
NEXT_PUBLIC_STORAGE_TYPE=redis
REDIS_URL=redis://localhost:6379

# Kvrocks 存储（推荐）
NEXT_PUBLIC_STORAGE_TYPE=kvrocks
KVROCKS_URL=redis://localhost:6666

# Upstash 存储
NEXT_PUBLIC_STORAGE_TYPE=upstash
UPSTASH_REDIS_REST_URL=https://your-upstash-instance.upstash.io
UPSTASH_REDIS_REST_TOKEN=your-token

# Turso 存储
NEXT_PUBLIC_STORAGE_TYPE=turso
TURSO_DATABASE_URL=libsql://your-database.turso.io
TURSO_AUTH_TOKEN=your-auth-token
```

## 📱 客户端支持

### Android TV 客户端

完美支持 [OrionTV](https://github.com/zimplexing/OrionTV) 客户端：

```bash
# OrionTV 配置地址
https://chy本尊.top/api/orion
```

### TVBox 配置

支持标准 TVBox 配置格式：

```bash
# TVBox 配置地址
https://chy本尊.top/api/tvbox/config
```

## 🔧 开发指南

### 本地开发环境

```bash
# 克隆项目
git clone https://gitee.com/CHYbenzun666/chydequanbuwangzhan.git
cd CHY-TV

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev
```

### 构建与部署

```bash
# 构建生产版本
pnpm build

# 启动生产服务器
pnpm start
```

## 📚 API 文档

### CHY-TV核心 API 端点

- `GET /api/search` - 聚合搜索接口
- `GET /api/play` - 视频播放接口
- `POST /api/user/register` - 用户注册
- `POST /api/user/login` - 用户登录
- `GET /api/config` - 获取站点配置
- `GET /api/danmaku` - 获取弹幕
- `POST /api/danmaku` - 发送弹幕

详细 API 文档请参考 [API 文档](./docs/API.md)

## 🔒 安全说明

### 部署安全建议

1. **设置强密码** - 为管理员账户设置复杂密码
2. **启用 HTTPS** - 生产环境务必使用 HTTPS
3. **定期更新** - 及时更新到最新版本
4. **访问控制** - 限制不必要的公网访问

### 隐私保护

- 所有用户数据加密存储
- 支持内容过滤功能
- 无用户行为追踪
- 支持匿名浏览模式

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

### 开发流程

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

### 代码规范

- 使用 TypeScript
- 遵循 ESLint 规则
- 编写单元测试
- 保持代码简洁

## 📄 许可证

本项目采用 [MIT License](./LICENSE)

## 🙏 致谢

- [Next.js](https://nextjs.org/) - React 框架
- [Tailwind CSS](https://tailwindcss.com/) - CSS 框架
- [ArtPlayer](https://github.com/zhw2590582/ArtPlayer) - 视频播放器
- [HLS.js](https://github.com/video-dev/hls.js/) - HLS 支持
- 所有开源贡献者

## 💝 支持项目

如果这个项目对你有帮助，请考虑：

- ⭐ Star 本项目
- 📢 推荐给朋友
- 🤩 关注微信公众号：CHY本尊

  ![给个关注吧](public/给个关注吧.jpg)

---

<div align="center">
  <p>
    <strong>🌟 喜欢这个项目？请给个 Star 支持一下！🌟</strong>
  </p>
</div>