Fix Docker method

2025-08-30 23:53:34 +08:00 · 2025-08-30 23:53:34 +08:00 · 42c5f445be
parent ac3a42d0e3
commit 42c5f445be
5 changed files with 199 additions and 12 deletions
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@ -13,8 +13,8 @@
 ### 1. 快速启动

 ```bash
-# 拉取最新镜像（当前镜像沿用上游命名空间）
-docker pull ghcr.io/senshinya/moontv:latest
+# 拉取最新镜像
+docker pull ghcr.io/katelya77/katelyatv:latest

 # 启动容器
 docker run -d \
@ -22,7 +22,7 @@ docker run -d \
  -p 3000:3000 \
  --env PASSWORD=your_password \
  --restart unless-stopped \
-  ghcr.io/senshinya/moontv:latest
+  ghcr.io/katelya77/katelyatv:latest
 ```

 ### 2. 访问应用
@ -91,11 +91,13 @@ nano .env.local
 ```

 **必需配置：**
+
 ```bash
 PASSWORD=your_secure_password
 ```

 **推荐配置：**
+
 ```bash
 SITE_NAME=我的影视站
 NEXT_PUBLIC_STORAGE_TYPE=localstorage
@ -197,15 +199,19 @@ NEXT_PUBLIC_STORAGE_TYPE=d1
 ## 🚨 常见问题

 ### Q: 无法访问应用
+
 **A:** 检查端口是否被占用，防火墙设置，或尝试其他端口。

 ### Q: 搜索无结果
+
 **A:** 检查网络连接，资源站点是否可用，或尝试其他关键词。

 ### Q: 视频无法播放
+
 **A:** 检查视频源是否有效，浏览器是否支持相关格式。

 ### Q: 数据丢失
+
 **A:** 如果使用 localStorage，数据存储在浏览器中，清除缓存会丢失数据。

 ## 📱 移动端使用
@ -233,10 +239,11 @@ NEXT_PUBLIC_STORAGE_TYPE=d1
 现在您已经完成了基础配置，可以开始享受 KatelyaTV 带来的影视体验了！

 **重要提醒：**
+
 - 本项目仅供学习和个人使用
 - 请遵守当地法律法规
 - 不要用于商业用途或公开服务

 ---

-如有任何问题，欢迎在 GitHub 上提出 Issue 或参与讨论！
+如有任何问题，欢迎在 GitHub 上提出 Issue 或参与讨论！
--- a/README.md
+++ b/README.md
@ -176,11 +176,11 @@

 ```bash
 # 拉取预构建镜像
-docker pull ghcr.io/senshinya/moontv:latest
+docker pull ghcr.io/katelya77/katelyatv:latest

 # 运行容器
 # -d: 后台运行  -p: 映射端口 3000 -> 3000
-docker run -d --name katelyatv -p 3000:3000 --env PASSWORD=your_password ghcr.io/senshinya/moontv:latest
+docker run -d --name katelyatv -p 3000:3000 --env PASSWORD=your_password ghcr.io/katelya77/katelyatv:latest
 ```

 访问 `http://服务器 IP:3000` 即可。（需自行到服务器控制台放通 `3000` 端口）
@ -194,7 +194,7 @@ docker run -d --name katelyatv -p 3000:3000 --env PASSWORD=your_password ghcr.io
 ```yaml
 services:
  katelyatv:
-    image: ghcr.io/senshinya/moontv:latest
+    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
@ -211,7 +211,7 @@ services:
 ```yaml
 services:
  katelyatv-core:
-    image: ghcr.io/senshinya/moontv:latest
+    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@ -3,12 +3,14 @@
 > 本项目在「MoonTV」基础上进行二创与继承，由 Katelya 持续维护。保留并致谢原作与社区贡献，在不改变核心理念的前提下，专注于更易部署、更友好体验与更稳定维护。

 ## 亮点
+
 - 全面延续上游核心：多源聚合搜索、在线播放、收藏与观看历史、PWA 支持、响应式布局、多用户系统等
 - 文档重写与梳理：README、QUICKSTART、PROJECT_STATUS、CONTRIBUTING、CHANGELOG 全面适配 KatelyaTV 品牌
 - 部署指引优化：Vercel / Docker / Cloudflare Pages 一站式说明，提供 Compose 最佳实践
 - 安全与隐私提醒：新增部署安全提示与法律风险说明

 ## 变更摘要
+
 - 品牌与文档
  - 将项目品牌统一为 KatelyaTV，并明确二创与继承来源
  - 更新部署与使用说明，优化快速上手体验
@ -18,36 +20,43 @@
  - 默认站点名改为 `KatelyaTV`（可通过 `SITE_NAME` 环境变量覆盖）

 ## 安装与升级
+
 - 首次安装（Docker 推荐）
+
 ```bash
-# 拉取镜像（当前仍沿用上游命名空间）
-docker pull ghcr.io/senshinya/moontv:latest
+# 拉取镜像
+docker pull ghcr.io/katelya77/katelyatv:latest

 # 启动示例
 docker run -d --name katelyatv \
  -p 3000:3000 \
  --env PASSWORD=your_password \
  --restart unless-stopped \
-  ghcr.io/senshinya/moontv:latest
+  ghcr.io/katelya77/katelyatv:latest
 ```
+
 - 或使用 README 中的 Docker Compose 示例

 ## 兼容性
+
 - 保持与上游 MoonTV v0.1.0 行为一致
 - 支持存储后端：localStorage / Redis / Cloudflare D1 / Upstash Redis
 - 运行环境：Node.js 18+；容器镜像支持多架构

 ## 已知问题
+
 - 部分第三方资源站可用性受其自身状态影响
 - Android TV 端收藏与网页端暂未完全互通（后续版本优化）

 ## 后续路线
+
 - 弹幕系统、字幕支持、下载功能、社交分享
 - 数据同步与多端互通完善
 - 性能与稳定性持续优化

 ## 鸣谢
+
 - 原始项目 MoonTV 及其作者与社区
 - 所有为本项目提供反馈、贡献代码与文档的开发者

-— Katelya
+— Katelya
--- a/RELEASE_NOTES_V0.2.0.md
+++ b/RELEASE_NOTES_V0.2.0.md
@ -0,0 +1,167 @@
+# KatelyaTV v0.2.0 发布说明
+
+> 本版本主要修复了 Docker 部署配置问题，确保用户能够正确使用 KatelyaTV 的 Docker 镜像进行部署。
+
+## 🚀 重要更新
+
+### Docker 部署修复
+
+- **修复镜像路径**：将所有文档中的 Docker 镜像路径从 `ghcr.io/senshinya/moontv:latest` 更新为 `ghcr.io/katelya77/katelyatv:latest`
+- **统一部署说明**：确保 README.md、QUICKSTART.md 和发布说明中的 Docker 部署指令一致
+- **验证部署流程**：确认所有 Docker Compose 配置文件使用正确的镜像路径
+
+### 代码兼容性验证
+
+- **构建验证**：通过完整的构建测试，确保所有 KatelyaTV 品牌更改不影响功能
+- **向后兼容**：保持与 MoonTV v0.1.0 的完全兼容性
+- **环境变量支持**：支持通过 `SITE_NAME` 等环境变量自定义配置
+
+## 🐳 Docker 部署指南
+
+### 快速启动
+
+```bash
+# 拉取最新镜像
+docker pull ghcr.io/katelya77/katelyatv:latest
+
+# 启动容器
+docker run -d \
+  --name katelyatv \
+  -p 3000:3000 \
+  --env PASSWORD=your_password \
+  --restart unless-stopped \
+  ghcr.io/katelya77/katelyatv:latest
+```
+
+### Docker Compose 部署
+
+#### 基础版本（localStorage）
+
+```yaml
+services:
+  katelyatv:
+    image: ghcr.io/katelya77/katelyatv:latest
+    container_name: katelyatv
+    restart: unless-stopped
+    ports:
+      - '3000:3000'
+    environment:
+      - PASSWORD=your_password
+```
+
+#### Redis 版本（推荐，支持多用户）
+
+```yaml
+services:
+  katelyatv-core:
+    image: ghcr.io/katelya77/katelyatv:latest
+    container_name: katelyatv
+    restart: unless-stopped
+    ports:
+      - '3000:3000'
+    environment:
+      - USERNAME=admin
+      - PASSWORD=admin_password
+      - NEXT_PUBLIC_STORAGE_TYPE=redis
+      - REDIS_URL=redis://katelyatv-redis:6379
+      - NEXT_PUBLIC_ENABLE_REGISTER=true
+    networks:
+      - katelyatv-network
+    depends_on:
+      - katelyatv-redis
+
+  katelyatv-redis:
+    image: redis
+    container_name: katelyatv-redis
+    restart: unless-stopped
+    networks:
+      - katelyatv-network
+    volumes:
+      - ./data:/data
+
+networks:
+  katelyatv-network:
+    driver: bridge
+```
+
+## 📋 环境变量配置
+
+| 变量名                        | 说明                                      | 默认值         | 示例                     |
+| ----------------------------- | ----------------------------------------- | -------------- | ------------------------ |
+| `PASSWORD`                    | 访问密码（localStorage 模式）或管理员密码 | -              | `your_password`          |
+| `USERNAME`                    | 管理员用户名（非 localStorage 模式）      | -              | `admin`                  |
+| `SITE_NAME`                   | 站点名称                                  | `KatelyaTV`    | `我的影视站`             |
+| `NEXT_PUBLIC_STORAGE_TYPE`    | 存储类型                                  | `localstorage` | `redis`, `d1`, `upstash` |
+| `REDIS_URL`                   | Redis 连接地址                            | -              | `redis://localhost:6379` |
+| `NEXT_PUBLIC_ENABLE_REGISTER` | 是否开放注册                              | `false`        | `true`                   |
+
+## 🔧 部署验证
+
+部署完成后，请验证以下功能：
+
+1. **基础访问**：浏览器访问 `http://localhost:3000` 能正常打开
+2. **密码验证**：使用设置的密码能正常登录
+3. **搜索功能**：能正常搜索和播放视频
+4. **数据持久化**：重启容器后数据保持（Redis 模式）
+
+## 🐛 已知问题
+
+- 部分第三方资源站可用性受其自身状态影响
+- Android TV 端收藏与网页端暂未完全互通（计划在后续版本优化）
+
+## 📝 变更日志
+
+### 修复
+
+- 修复 README.md 中 Docker 镜像路径错误
+- 修复 QUICKSTART.md 中 Docker 部署说明
+- 修复 Docker Compose 配置示例中的镜像路径
+
+### 改进
+
+- 统一所有文档中的 Docker 部署说明
+- 完善环境变量配置说明
+- 添加部署验证步骤
+
+### 兼容性
+
+- 保持与 MoonTV v0.1.0 完全兼容
+- 支持从旧版本无缝升级
+- 保留所有现有功能和配置选项
+
+## 🔄 升级指南
+
+### 从 v0.1.0-katelya 升级
+
+```bash
+# 停止旧容器
+docker stop katelyatv
+docker rm katelyatv
+
+# 拉取新镜像
+docker pull ghcr.io/katelya77/katelyatv:latest
+
+# 使用新镜像启动
+docker run -d \
+  --name katelyatv \
+  -p 3000:3000 \
+  --env PASSWORD=your_password \
+  --restart unless-stopped \
+  ghcr.io/katelya77/katelyatv:latest
+```
+
+### 从 MoonTV 迁移
+
+如果您之前使用的是 MoonTV，只需将 Docker 镜像路径更改为 `ghcr.io/katelya77/katelyatv:latest`，其他配置保持不变。
+
+## 🙏 鸣谢
+
+- 感谢社区用户反馈的 Docker 部署问题
+- 感谢原始项目 MoonTV 及其作者与社区
+- 感谢所有为本项目提供反馈和建议的开发者
+
+---
+
+**完整部署文档**：请参考 [README.md](README.md) 和 [QUICKSTART.md](QUICKSTART.md)
+
+— Katelya
--- a/public/sw.js
+++ b/public/sw.js