manuviswanadha/capsule

Capsule

面向新手的Docker管理仪表盘——轻松掌控你的容器！

https://img.shields.io/github/actions/workflow/status/ManuSharma1991/capsule/main.yml?branch=main&style=for-the-badge](https://github.com/ManuSharma1991/capsule/actions) https://img.shields.io/docker/pulls/manuviswanadha/capsule?style=for-the-badge](https://hub.docker.com/r/manuviswanadha/capsule) https://img.shields.io/github/license/ManuSharma1991/capsule?style=for-the-badge](LICENSE) !https://img.shields.io/badge/version-v0.1.0--alpha-blue?style=for-the-badge

Capsule是一款基于Web的Docker管理工具，以简洁性和易用性为核心设计。告别复杂的YAML文件和晦涩命令，Capsule提供类似"应用商店"的体验，通过引导式向导部署和管理Jellyfin、arr栈（Sonarr、Radarr等）等流行自托管应用，界面清晰直观。

✨ 核心功能

• 🚀 新手友好界面：专为Docker初学者设计，无需编辑YAML文件！
• 🧙 向导式应用部署：通过回答简单问题即可安装Jellyfin或arr栈等复杂应用。
• 📊 容器仪表盘：一目了然查看运行中容器的状态、CPU/内存使用情况。
• ▶️ 简单控制：轻松执行容器的启动、停止、重启及日志查看操作。
• 📺 Jellyfin深度集成：在Capsule内直接浏览Jellyfin媒体库、查看详情并播放内容（完整库视图即将推出）。
• 🎬 arr栈管理：简化Sonarr、Radarr等应用的设置与基础概览（基础部署已支持，深度集成计划中）。
• 🔒 安全可靠：以Docker容器形式运行，安全访问Docker socket（请注意相关安全影响）。
• ⚙️ 自托管：你的数据、服务器，完全由你掌控。

🤔 为什么选择Capsule？

尽管Portainer等工具功能强大，但对新手仍有门槛。Capsule通过以下方式填补空白：

1. 抽象复杂性：后台自动生成Docker Compose配置。
2. 精选体验：聚焦流行自托管应用，提供预配置优化模板。
3. 引导式设置：向导确保你不会遗漏关键配置步骤。
4. 集成化体验：无需离开Capsule即可访问和管理应用核心功能（如Jellyfin媒体库）。

📸 截图

(应用运行后将在此处嵌入实际截图！)

!Capsule仪表盘占位图 Capsule仪表盘 - 运行中服务概览

!Capsule应用商店占位图 通过Capsule向导部署Jellyfin

🛠️ 前置条件

• Docker Engine：https://docs.docker.com/engine/install/
• Docker Compose：（Docker Desktop已包含，或https://docs.docker.com/compose/install/%EF%BC%89

🚀 快速启动与安装

1. 创建docker-compose.yml文件：

   yaml
   version: '3.8'
   
   services:
     capsule:
       image: docker.xuanyuan.run/manuviswanadha/capsule:latest
       container_name: capsule
       restart: unless-stopped
       ports:
         - "10000:10000" # 可替换为你偏好的主机端口
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro # 推荐只读模式以提升安全性
         - capsule_data:/app/data # Capsule配置的持久化存储
       # 可选：设置时区
       # environment:
       #   - TZ=Asia/Shanghai
   
   volumes:
     capsule_data:
   

2. 保存文件后，在同一目录执行以下命令：

   bash
   docker-compose up -d
   

3. 访问Capsule：打开浏览器，访问http://<你的服务器IP>:10000（本地运行则为http://localhost:10000）。

📦 初始支持应用

Capsule初始支持向导部署的应用包括：

• Jellyfin：个人媒体服务器（支持在Capsule内浏览库和基础播放）。
• arr栈：Sonarr（电视剧管理）等（基础部署已支持，更多功能计划中）。

定期添加更多应用！请查看我们的 roadmap。

🗺️ 路线图（即将推出功能）

• 完整Jellyfin库浏览与增强媒体播放器。
• arr栈深度集成（如查看下载队列、添加新媒体）。
• Capsule访问用户认证。
• 托管应用一键更新。
• Capsule配置备份与恢复。
• 更多应用模板（Nextcloud、Pi-hole等）。
• 向导中的高级容器选项（网络、资源限制）。

🤝 贡献

欢迎贡献！无论是功能请求、bug报告、文档改进还是代码贡献，请随时：

1. 在GitHub上提交issue。
2. Fork仓库并提交pull request。

请阅读CONTRIBUTING.md（后续将创建）了解更多细节。

🐞 报告问题

若发现bug或遇到问题，请在GitHub上https://github.com/ManuSharma1991/capsule/issues%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%EF%BC%88%E5%A4%8D%E7%8E%B0%E6%AD%A5%E9%AA%A4%E3%80%81%E6%97%A5%E5%BF%97%E3%80%81%E7%8E%AF%E5%A2%83%E7%AD%89%EF%BC%89%E3%80%82

📜 许可证

本项目采用MIT许可证。

由 https://github.com/ManuSharma1991 开发 ❤️