install_desktop 安装 · 无许可费用 & 开源

自行运行 Klacks — 在您自己的基础设施上。

三条路径，同一结果：适用于办公电脑的 Windows 软件包、适用于您服务器的引导式安装程序，或适用于自有环境的 Docker Compose 堆栈 — 无需注册，没有许可费用。使用办公电脑时，您在安装过程中选择国家；服务器和 Docker Compose 的国家套件随附您所在国家的法定节假日、工时规则和行业预设（工时加成以该国家已定义的为准）。

国家套件

选择行业 — 可选

您的选择将作为预设写入国家配置文件，并决定首次启动时激活哪些行业模块。套件始终包含所有行业 — 您随时可以在应用中激活更多行业。

computer

在办公电脑上（无需 Docker）

适用于只有一台办公电脑的企业：适用于 Windows 的安装程序 — 无需 Docker，也无需自有服务器。数据库、Klacks 和更新服务作为 Windows 后台服务运行，更新会自动安装，您的数据保留在这台电脑上。

前提条件

check_circle Windows 11（64 位）
check_circle 也可在 Windows 10 22H2（64 位）上运行。Microsoft 已不再为 Windows 10 提供常规支持；安全更新仅通过付费的 ESU 计划提供。
check_circle Klacks 直接在这台电脑上使用 — 暂不支持从网络中的其他设备访问
check_circle 首次启动时（AI 模型，约 700 MB）及更新时需要互联网连接
check_circle 安装需要管理员权限

只需三步

1

下载安装程序点击「下载 Windows 版」。文件「Klacks-Setup-win-x64.exe」通常会保存在「下载」文件夹中。
2

双击并选择国家双击该文件。如果 Windows SmartScreen 显示警告，请打开更多信息并选择仍然运行 — 该安装程序暂时还没有数字签名。随后确认管理员权限请求。在安装向导中选择您所在的国家（节假日、时区、工时规则），如有需要还可以创建桌面快捷方式。向导会显示安装进度，安装需要几分钟。
3

打开 Klacks 并登录最后选择在浏览器中打开 Klacks。之后可以在开始菜单中通过「Klacks」打开（或访问 http://localhost:5180）。使用向导最后显示的初始账户登录，并创建您自己的管理员账户。如果 Klacks 仍在启动，请等待几分钟 — 首次启动需要稍长一些时间。

download 下载 Windows 版

适用于 64 位 Windows（x64）。在搭载 ARM 处理器的 Windows 11 设备（例如 Snapdragon X）上，Klacks 通过仿真运行；不支持 ARM 版 Windows 10。

Mac 版：即将推出。

使用 Linux？请见下文：在 Linux 电脑上使用 Klacks。

卸载：Klacks 可以像其他 Windows 程序一样卸载 — 打开「设置 › 应用」，找到「Klacks」条目并将其卸载。卸载程序会询问是否同时删除数据库、设置和备份。如果选择「否」，您的数据会保留在 C:\ProgramData\Klacks 中，以后重新安装时会继续使用。

dns

引导式安装程序

适用于自有服务器的引导式路径：安装脚本生成密钥和自签名证书，拉取最新发布版本并启动整个堆栈 — 支持 Linux 和 Windows。

前提条件

check_circle Docker Desktop（Windows）或带 Compose 插件的 Docker Engine（Linux）
check_circle 可对外访问 ghcr.io 和 github.com（镜像与更新）
check_circle 空闲端口 80 和 443（可配置）

三个步骤

1

下载并解压下载适用于您所在国家的 ZIP，并在目标机器上解压。
2

运行安装脚本在 Linux 上运行随附的 Shell 脚本，在 Windows 上运行 PowerShell 脚本。脚本会生成密钥和证书，应用国家配置文件，并等待堆栈正常运行。
3

登录并修改密码在浏览器中登录，并立即修改随附 README 中列出的初始密码。

download 下载安装包

klacks-onprem-cn-all.zip

deployed_code

Docker Compose

适用于自行管理容器堆栈的团队的直接路径：docker-compose.yml、nginx 配置、初始化脚本、国家配置文件，以及一份包含所有变量的 .env 模板 — 完全的控制权在您手中。

前提条件

check_circle 带 Compose 插件的 Docker Engine（或 Docker Desktop）
check_circle 可对外访问 ghcr.io 和 github.com（镜像与更新）
check_circle 具备运行 Docker Compose 堆栈的经验

三个步骤

1

下载并解压下载适用于您所在国家的 Compose ZIP 并解压 — 随附的 README 详细说明每一步。
2

配置 .env 将 .env.example 模板复制为 .env，设置服务器名称以及密码/密钥。国家配置文件的路径已预先填好。
3

启动堆栈运行「docker compose up -d」，在浏览器中登录并立即修改初始密码。

download 下载 Compose 套件

klacks-compose-cn-all.zip

terminal

在 Linux 电脑上

适用于 Linux 电脑的简单方式，无需任何预备知识：下载软件包，在终端中输入一次命令 — 其余工作由安装程序完成。之后 Klacks 通过 Docker 在这台电脑上运行，更新会自动安装，您的数据保留在这台电脑上。

前提条件

check_circle 带桌面环境的 64 位 Linux：Ubuntu、Debian 或 Fedora。其他发行版（例如 Linux Mint）未获官方支持 — 在这些系统上，请先自行安装 Docker。
check_circle 建议 16 GB 内存，因为浏览器和桌面也会同时运行。内存低于约 8 GB 时，安装程序会中止。
check_circle 首次启动时及更新时需要互联网连接
check_circle 这台电脑的管理员密码（sudo 密码）

download 下载 Linux 版

klacks-onprem-cn-all.zip

只需三步

1

下载软件包并解压到固定文件夹下载 ZIP 文件，并解压到一个长期保留的文件夹中，例如主文件夹中的「klacks」文件夹 — 不要放在「下载」文件夹中。自动更新会使用这个文件夹；如果删除它，更新将无法再进行。
2

打开终端并输入命令在存放已解压安装文件的文件夹中单击右键，选择「在终端中打开」，输入下方的命令，并用您的密码确认（输入时密码不会显示）。如果缺少 Docker，安装程序会提议为您安装：请回答「y」 — 这需要几分钟。安装时只需要用到这一次终端；如果以后再次运行安装程序（例如用于修复），也请使用这条包含 sudo 的相同命令。sudo bash install-cn.sh
3

在浏览器中打开并登录在浏览器中打开 https://localhost。浏览器会对证书发出警告 — 请确认该警告（点击「高级」，然后点击「继续前往」或「接受风险并继续」）。使用文件夹中 README 里的初始账户登录，并立即修改密码。

lock

关于证书警告：Klacks 在安装时会创建自己的证书，您的浏览器并不认识它 — 因此会出现警告。连接仍然是加密的。

description

仅配置文件 — 适用于现有安装

已经在运行 Klacks？该配置文件（JSON）包含国家预设 — 法定节假日、工时规则、工时加成（以该国家已定义的为准）和行业 — 并在安装首次启动时应用。之后要为现有安装补充另一个行业及其预设，也是通过这一方式。

description 下载配置文件（JSON）

值得了解

code

开源（AGPL-3.0）

完整源代码以 AGPL-3.0 许可证在 GitHub 上公开 — 没有许可费用，没有供应商锁定。

storage

数据存放在您的服务器上

Klacks 运行在您的基础设施上。人员和排班数据存放在您的服务器上 — 没有强制上云。只有在您选择外部 AI 服务商时，请求才会发送给对方；使用本地模型则没有 AI 请求发送给外部服务商。

update

更新

更新服务会自动应用新发布的版本 — 使用 Docker 时作为堆栈内的服务，在办公电脑上作为 Windows 后台服务。

lock

使用 Docker 时的 HTTPS

安装程序会生成自签名证书供您起步 — 您随时可以换成自己的证书。首次登录后请立即修改初始密码。办公电脑的 Windows 软件包无需证书，运行于 http://localhost:5180。

先试用，再安装？

在 Playground 中，您可以直接在浏览器里用示例数据试用 Klacks — 无需安装，无需注册。或者到 GitHub 上看看源代码。

code 在 GitHub 上查看