Hopya Vibe 项目

Hopya 是一款开源的自托管团队项目管理平台，专为希望拥有完全私有化工作空间、且不愿被强制绑定云服务的团队设计。所有数据存储在自有服务器，无需互联网连接即可运行，团队成员在局域网内即可协作，适合对数据主权有要求的企业与独立开发者社区。默认仅监听本地地址，暴露到公网需配合可信的 HTTPS 反向代理使用。

核心功能

多工作区与权限体系

支持多个独立工作区，每个工作区有专属管理员，可自定义成员角色（查看、编辑、管理员），实现跨部门或跨项目隔离，成员权限精确到字段级别。

多视图切换

同一套任务数据可在列表视图（List）、看板视图（Board）、日历视图（Calendar）、画廊视图（Gallery）和时间线视图（Timeline）之间自由切换，满足从甘特规划到日常卡片管理等多种工作流场景。

丰富任务属性

任务支持子任务、检查清单、状态、优先级、标签、截止日期、指派人等常用字段，还提供可配置的数字、文本、日期、单选、多选、评分、公式等自定义字段类型，适应不同团队的记录需求。

协作与沟通

工作区收件箱实时通知，支持 @成员、@任务、@结构引用，评论支持线程化回复与 emoji 表情反应，信息流转不依赖外部协作工具。

附件与存储灵活选型

附件可保存在本地文件系统或可选接入 S3 兼容对象存储服务，满足不同规模团队的基础设施选型需求。

安全认证与合规

本地账号注册体系，可选开启 OIDC 单点登录、密码找回、可撤销的 API Token，所有操作写入门审计记录，支持完整的操作溯源。

数据导入导出

支持 JSON/CSV 任务导入导出，以及完整工作区 JSON 导出，方便与外部系统对接或做定期备份。

版本化自动化工作流

提供图形化自动化编排界面，支持条件路由、凭证管理、执行监控，兼容旧版 Linear 风格的自动化配置，提供 Webhook、邮件、HTTP 自动化通道，可选接入 AI 辅助提案与 MCP（Model Context Protocol）访问。

技术实现

Hopya 通过 Docker Compose 部署，分为 API 容器（核心业务逻辑）、Web 容器（前端界面）和可选的 Proxy 容器（反向代理），数据默认持久化在宿主机的 ./data 目录，删除容器不会丢失数据。环境变量配置采用 .env 文件管理，启动前由配置初始化脚本生成加密密钥与一次性安装令牌，管理员令牌仅在首次建号时使用，之后存储于数据库中。生产环境推荐将 Proxy 容器或独立 Nginx/Caddy 作为 HTTPS 前置代理，将 APP_URL 设置为精确的公网入口地址，API 与 Web 容器不直接暴露到互联网。每一次 Git 标签发布会同步推送预构建的 API 与 Web 容器镜像（托管于 GHCR），生产部署可跳过本地构建直接拉取镜像更新。

快速上手

第一步，克隆或下载项目，进入目录执行 npm run init:env 生成 .env 配置文件（无 Node.js 时可通过 Docker 容器运行初始化脚本）。

第二步，在 .env 中确认 APP_URL（外部访问地址）、APP_KEY（应用加密密钥）、SETUP_TOKEN（首次建管令牌）等关键变量。

第三步，执行 docker compose up -d --build --wait 启动所有容器，查看 docker compose logs -f api web 确认启动状态。

第四步，浏览器访问 http://localhost:8888（或配置的 APP_URL），输入 SETUP_TOKEN 创建首位管理员账号。

第五步，创建第一个工作区 → 添加项目与列表 → 创建任务 → 在不同视图间切换体验，参考官方用户手册深入了解权限、字段配置与自动化编排。

适用人群

注重数据隐私的团队：对 Jira、Notion、Linear 等 SaaS 工具有数据合规顾虑，希望数据存储在自有基础设施。独立开发者社区：开源项目或技术社区需要内部任务管理工具，无需复杂的企业功能。中小制造企业与传统行业：IT 环境偏保守，业务系统不允许访问外部云服务，自托管是唯一可行方案。

开源信息

项目托管于 GitHub（wnzn/hopya），采用开源许可证（具体许可证类型以项目仓库 LICENSE 文件为准），欢迎开发者参与贡献或提交 Issue 反馈问题与功能建议。