install_desktop Cài đặt · Không mất phí bản quyền & mã nguồn mở

Tự vận hành Klacks — trên hạ tầng của riêng bạn.

Ba con đường, một kết quả: gói Windows cho máy tính văn phòng của bạn, trình cài đặt có hướng dẫn cho máy chủ của bạn, hoặc stack Docker Compose cho thiết lập riêng của bạn — không cần đăng ký, không phí bản quyền. Trên máy tính văn phòng, bạn chọn quốc gia trong lúc cài đặt; với máy chủ và Docker Compose, gói quốc gia đi kèm sẵn ngày lễ, quy định thời giờ làm việc và các thiết lập sẵn theo ngành của quốc gia bạn (giờ phụ trội nếu quốc gia đó có quy định).

Gói quốc gia

Chọn ngành của bạn — tùy chọn

Lựa chọn của bạn được ghi vào hồ sơ quốc gia dưới dạng thiết lập sẵn và quyết định những khối ngành nào được kích hoạt ở lần khởi động đầu tiên. Gói luôn chứa đầy đủ mọi ngành — bạn có thể kích hoạt thêm trong ứng dụng bất cứ lúc nào.

computer

Trên máy tính văn phòng (không cần Docker)

Dành cho doanh nghiệp chỉ có một máy tính văn phòng: một tệp cài đặt cho Windows — không cần Docker và không cần máy chủ riêng. Cơ sở dữ liệu, Klacks và dịch vụ cập nhật chạy dưới dạng dịch vụ nền của Windows, bản cập nhật được cài tự động, và dữ liệu của bạn được lưu trên chính máy tính này.

Yêu cầu
  • check_circle Windows 11 (64-bit)
  • check_circle Cũng chạy được trên Windows 10 22H2 (64-bit). Microsoft không còn cung cấp hỗ trợ thông thường cho Windows 10; các bản cập nhật bảo mật chỉ còn có thông qua chương trình ESU trả phí.
  • check_circle Klacks được dùng trực tiếp trên máy tính này — chưa hỗ trợ truy cập từ các thiết bị khác trong mạng
  • check_circle Kết nối Internet ở lần khởi động đầu tiên (các mô hình AI, khoảng 700 MB) và để cập nhật
  • check_circle Quyền quản trị viên để cài đặt
Chỉ với ba bước
  1. 1
    Tải tệp cài đặt Nhấp vào “Tải cho Windows”. Tệp “Klacks-Setup-win-x64.exe” thường được lưu trong thư mục “Tải xuống”.
  2. 2
    Nhấp đúp và chọn quốc gia Nhấp đúp vào tệp. Nếu Windows SmartScreen hiển thị cảnh báo, hãy mở phần thông tin thêm và chọn vẫn chạy — tệp cài đặt này chưa có chữ ký số. Sau đó xác nhận yêu cầu quyền quản trị viên. Trong trình hướng dẫn, chọn quốc gia của bạn (ngày lễ, múi giờ, quy định thời giờ làm việc) và nếu muốn, tạo lối tắt trên màn hình nền. Trình hướng dẫn hiển thị tiến trình; quá trình cài đặt mất vài phút.
  3. 3
    Mở Klacks và đăng nhập Ở bước cuối, chọn mở Klacks trong trình duyệt. Sau này bạn có thể tìm Klacks trong menu Start với tên “Klacks” (hoặc tại http://localhost:5180). Đăng nhập bằng tài khoản ban đầu mà trình hướng dẫn hiển thị ở cuối và tạo tài khoản quản trị viên của riêng bạn. Nếu Klacks vẫn đang khởi động, hãy chờ vài phút — lần khởi động đầu tiên mất nhiều thời gian hơn một chút.

Dành cho Windows 64-bit (x64). Trên các thiết bị Windows 11 dùng bộ xử lý ARM (ví dụ Snapdragon X), Klacks chạy thông qua giả lập; Windows 10 trên ARM không được hỗ trợ.

Dành cho Mac: sắp ra mắt.

Dùng Linux? Xem bên dưới: Klacks trên máy tính Linux.

Gỡ cài đặt: Bạn có thể gỡ Klacks như mọi chương trình Windows khác — mở Cài đặt › Ứng dụng, tìm mục “Klacks” và gỡ cài đặt. Trình gỡ cài đặt sẽ hỏi có xóa luôn cơ sở dữ liệu, cài đặt và bản sao lưu hay không. Nếu bạn trả lời không, dữ liệu của bạn vẫn nằm trong C:\ProgramData\Klacks và lần cài đặt lại sau này sẽ dùng lại chúng.

dns

Trình cài đặt có hướng dẫn

Con đường có hướng dẫn cho máy chủ của riêng bạn: một tập lệnh cài đặt sẽ tạo các khóa bí mật và chứng chỉ tự ký, kéo về phiên bản phát hành mới nhất và khởi động toàn bộ stack — trên Linux hoặc Windows.

Yêu cầu
  • check_circle Docker Desktop (Windows) hoặc Docker Engine với plugin Compose (Linux)
  • check_circle Kết nối ra ngoài tới ghcr.io và github.com (image và cập nhật)
  • check_circle Cổng 80 và 443 còn trống (có thể cấu hình)
Ba bước
  1. 1
    Tải về và giải nén Tải tệp ZIP cho quốc gia của bạn và giải nén trên máy đích.
  2. 2
    Chạy tập lệnh cài đặt Trên Linux chạy shell script đi kèm, trên Windows chạy tập lệnh PowerShell. Tập lệnh tạo các khóa bí mật và chứng chỉ, áp dụng hồ sơ quốc gia và chờ cho đến khi stack sẵn sàng hoạt động.
  3. 3
    Đăng nhập và đổi mật khẩu Đăng nhập từ trình duyệt và đổi ngay mật khẩu ban đầu được ghi trong README đi kèm.
download Tải gói cài đặt

klacks-onprem-vn-all.zip

deployed_code

Docker Compose

Con đường trực tiếp cho các đội ngũ tự quản lý stack container của mình: docker-compose.yml, cấu hình nginx, các script khởi tạo, hồ sơ quốc gia và một mẫu .env đã chuẩn bị sẵn với đầy đủ biến — bạn giữ toàn quyền kiểm soát.

Yêu cầu
  • check_circle Docker Engine với plugin Compose (hoặc Docker Desktop)
  • check_circle Kết nối ra ngoài tới ghcr.io và github.com (image và cập nhật)
  • check_circle Kinh nghiệm vận hành các stack Docker Compose
Ba bước
  1. 1
    Tải về và giải nén Tải tệp ZIP Compose cho quốc gia của bạn và giải nén — README đi kèm hướng dẫn từng bước.
  2. 2
    Thiết lập .env Sao chép mẫu .env.example thành .env và đặt tên máy chủ cùng các mật khẩu/khóa bí mật. Đường dẫn tới hồ sơ quốc gia đã được điền sẵn.
  3. 3
    Khởi động stack Chạy “docker compose up -d”, đăng nhập từ trình duyệt và đổi ngay mật khẩu ban đầu.
download Tải gói Compose

klacks-compose-vn-all.zip

terminal

Trên máy tính Linux

Cách đơn giản cho máy tính Linux, không cần kiến thức chuyên môn: tải gói về, nhập một lệnh trong terminal một lần duy nhất — trình cài đặt sẽ lo phần còn lại. Sau đó Klacks chạy bằng Docker trên máy tính này, bản cập nhật được cài tự động, và dữ liệu của bạn được lưu trên chính máy tính này.

Yêu cầu
  • check_circle Linux 64-bit có giao diện desktop: Ubuntu, Debian hoặc Fedora. Các bản phân phối khác (ví dụ Linux Mint) không được hỗ trợ chính thức — trên các bản đó, vui lòng tự cài Docker trước.
  • check_circle Khuyến nghị 16 GB bộ nhớ RAM, vì trình duyệt và giao diện desktop chạy song song. Dưới khoảng 8 GB, trình cài đặt sẽ dừng lại.
  • check_circle Kết nối Internet ở lần khởi động đầu tiên và để cập nhật
  • check_circle Mật khẩu quản trị viên (mật khẩu sudo) của máy tính này
download Tải cho Linux

klacks-onprem-vn-all.zip

Chỉ với ba bước
  1. 1
    Tải gói và giải nén vào một thư mục cố định Tải tệp ZIP về và giải nén vào một thư mục sẽ được giữ nguyên lâu dài, ví dụ thư mục “klacks” trong thư mục cá nhân (home) của bạn — không phải trong thư mục “Downloads”. Các bản cập nhật tự động làm việc với thư mục này; nếu thư mục bị xóa, việc cập nhật sẽ không còn hoạt động.
  2. 2
    Mở terminal và nhập lệnh Trong thư mục chứa các tệp cài đặt đã giải nén, nhấp chuột phải và chọn “Mở trong Terminal”, nhập lệnh bên dưới rồi xác nhận bằng mật khẩu của bạn (mật khẩu không hiển thị khi gõ). Nếu chưa có Docker, trình cài đặt sẽ đề nghị cài đặt: trả lời “y” — việc này mất vài phút. Bạn chỉ cần dùng terminal một lần này để cài đặt; nếu sau này chạy lại trình cài đặt (ví dụ để sửa lỗi), hãy dùng đúng lệnh này, kể cả sudo.sudo bash install-vn.sh
  3. 3
    Mở trong trình duyệt và đăng nhập Mở https://localhost trong trình duyệt. Trình duyệt sẽ cảnh báo về chứng chỉ — hãy xác nhận cảnh báo (“Nâng cao” rồi “Tiếp tục” hoặc “Chấp nhận rủi ro”). Đăng nhập bằng tài khoản ban đầu ghi trong README trong thư mục và đổi mật khẩu ngay.
lock

Về cảnh báo chứng chỉ: khi cài đặt, Klacks tạo một chứng chỉ riêng mà trình duyệt của bạn không biết — vì vậy mới có cảnh báo. Kết nối vẫn được mã hóa.

description

Chỉ hồ sơ — cho các bản cài đặt hiện có

Bạn đã chạy Klacks rồi? Hồ sơ (JSON) chứa các thiết lập sẵn của quốc gia — ngày lễ, quy định thời giờ làm việc, giờ phụ trội (nếu quốc gia có quy định) và ngành nghề — và được áp dụng ở lần khởi động đầu tiên của một bản cài đặt. Đây cũng là cách để bổ sung thêm một ngành cùng các thiết lập sẵn của nó về sau.

description Tải hồ sơ (JSON)

Những điều nên biết

code

Mã nguồn mở (AGPL-3.0)

Toàn bộ mã nguồn được công khai trên GitHub theo giấy phép AGPL-3.0 — không phí bản quyền, không bị khóa chặt vào nhà cung cấp.

storage

Dữ liệu nằm trên máy chủ của bạn

Klacks chạy trên hạ tầng của bạn. Dữ liệu nhân sự và lịch làm việc nằm trên máy chủ của bạn — không có chuyện ép buộc dùng cloud. Chỉ khi bạn chọn nhà cung cấp AI bên ngoài thì các yêu cầu mới được gửi đến họ; với mô hình cục bộ, không có yêu cầu AI nào được gửi đến nhà cung cấp bên ngoài.

update

Cập nhật

Một dịch vụ cập nhật sẽ tự động áp dụng các phiên bản mới được phát hành — với Docker là dịch vụ bên trong stack, trên máy tính văn phòng là dịch vụ chạy nền của Windows.

lock

HTTPS với Docker

Trình cài đặt tạo một chứng chỉ tự ký để bạn khởi đầu — bạn có thể chuyển sang chứng chỉ riêng bất cứ lúc nào. Hãy đổi mật khẩu ban đầu ngay sau lần đăng nhập đầu tiên. Gói Windows cho máy tính văn phòng chạy không cần chứng chỉ tại http://localhost:5180.

Dùng thử trước, cài đặt sau?

Playground cho phép bạn thử Klacks ngay trong trình duyệt với dữ liệu mẫu — không cần cài đặt, không cần đăng ký. Hoặc xem mã nguồn trên GitHub.

code Xem trên GitHub
Reload X