Repolode
hcengineering

hcengineering/huly-selfhost

用于自托管 Huly 的 Docker Compose 与 Kubernetes 部署配置,Huly 是一套开源的一体化团队协作平台。

可替代:SlackLinearJira

Star
3,576
Fork
470
未关闭 Issue
138
最近提交
22天前

这是什么?

本仓库提供在自有服务器上部署 Huly 团队协作平台的配置,包括带 nginx 反向代理的 Docker Compose 方案、生成配置的 setup 脚本,以及 kube 目录下的 Kubernetes 示例。平台源码位于另一个仓库。

部署栈包含多个服务,其中 CockroachDB 负责存储,Redpanda 负责消息队列,Elasticsearch 负责搜索。可选组件涵盖邮件(SMTP 或 Amazon SES)、基于 LiveKit 的音视频通话、网页推送通知、Gmail 与 Google 日历集成、GitHub 和 Telegram 集成、OpenID Connect 与 GitHub 登录,以及基于 OpenAI 的 AI 聊天机器人。数据可使用 Docker 命名卷,也可指定宿主机路径。

建议配置至少 2 核 CPU 与 8 GB 内存,推荐 4 核与 16 GB 或更高。升级时修改环境文件中的 Huly 版本号即可,不同版本的额外步骤记录在 MIGRATION.md 中。

核心功能

  • 01基于 Docker Compose 的部署栈,包含 nginx 反向代理和生成配置的 setup 脚本
  • 02提供可选的 Kubernetes 示例配置
  • 03支持通过 SMTP 或 Amazon SES 发送邮件通知
  • 04基于 LiveKit 的音视频通话
  • 05支持 GitHub 双向同步 issue 与 PR,并可接入 Google 日历和 Telegram
  • 06支持 OpenID Connect 与 GitHub OAuth 登录,并可关闭公开注册

适用场景

  • 在自有 Linux 服务器上搭建私有的团队协作空间,用于聊天、任务和文档
  • 在正式上线前用快速启动脚本本地试用 Huly
  • 接入现有的 OIDC 身份提供方,统一管理登录用户

快速上手

  1. 1

    克隆 huly-selfhost 仓库

    git clone https://github.com/hcengineering/huly-selfhost.git
  2. 2

    进入项目目录

    cd huly-selfhost
  3. 3

    运行快速本地设置脚本

    ./setup.sh --quick
  4. 4

    约60秒后在浏览器中打开 localhost:8087 访问 Huly

使用前须知

  • 需要至少 2 个 vCPU 和 8 GB 内存的服务器,推荐 4 个 vCPU 和 16 GB 内存。
  • 随附的 CockroachDB 和 Redpanda 配置可能不适合生产环境。
  • 快速启动模式仅适用于本地测试。

标签

常见问题

huly-selfhost 是什么?
用于自托管 Huly 的 Docker Compose 与 Kubernetes 部署配置,Huly 是一套开源的一体化团队协作平台。 本仓库提供在自有服务器上部署 Huly 团队协作平台的配置,包括带 nginx 反向代理的 Docker Compose 方案、生成配置的 setup 脚本,以及 kube 目录下的 Kubernetes 示例。平台源码位于另一个仓库。
huly-selfhost 可以免费使用吗?用的什么许可证?
huly-selfhost 以 EPL-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
huly-selfhost 还在维护吗?
活跃维护中。huly-selfhost 最近一次提交是在 2026年9月29日。
huly-selfhost 适合用来做什么?
在自有 Linux 服务器上搭建私有的团队协作空间,用于聊天、任务和文档 在正式上线前用快速启动脚本本地试用 Huly 接入现有的 OIDC 身份提供方,统一管理登录用户
huly-selfhost 怎么安装和运行?
克隆 huly-selfhost 仓库: git clone https://github.com/hcengineering/huly-selfhost.git 进入项目目录: cd huly-selfhost 运行快速本地设置脚本: ./setup.sh --quick 约60秒后在浏览器中打开 localhost:8087 访问 Huly
在哪里获取 huly-selfhost?
源代码和安装说明在 GitHub 上:https://github.com/hcengineering/huly-selfhost

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目