DPTCloud
Quay lại danh sách
Tin tức công nghệ

Hướng Dẫn Triển Khai Stirling-PDF Multi-User Tích Hợp Authentik OIDC Trên VPS Cho Phòng Kế Toán

27 tháng 5, 2026

1. Đặt vấn đề: Thách thức bảo mật tài liệu số của phòng Kế toán doanh nghiệp

Trong kỷ nguyên chuyển đổi số, phòng Kế toán luôn là bộ phận sở hữu khối lượng dữ liệu nhạy cảm lớn nhất doanh nghiệp, từ báo cáo tài chính, hóa đơn, chứng từ thuế cho đến thông tin lương nhân viên. Hầu hết các tài liệu này đều định dạng dưới dạng PDF. Để xử lý các tác vụ như gộp file, tách trang, ký số hay đặt mật khẩu bảo vệ, nhiều nhân viên kế toán có thói quen sử dụng các công cụ trực tuyến miễn phí trên internet.

Tuy nhiên, thói quen này tiềm ẩn rủi ro cực kỳ nghiêm trọng về rò rỉ dữ liệu (Data Leakage). Khi tải một tài liệu nội bộ lên bên thứ ba không rõ nguồn gốc, doanh nghiệp hoàn toàn mất quyền kiểm soát đối với thông tin đó. Để giải quyết triệt để bài toán này, việc xây dựng một hạ tầng xử lý PDF nội bộ, bảo mật và độc lập là yêu cầu cấp thiết.

Stirling-PDF nổi lên như một giải pháp mã nguồn mở thay thế hoàn hảo cho các dịch vụ trả phí đắt đỏ như Adobe Acrobat Pro. Khi được cấu hình phiên bản Multi-User kết hợp hệ thống xác thực tập trung Authentik OIDC trên máy chủ ảo (VPS) riêng, doanh nghiệp sẽ sở hữu một hệ sinh thái quản trị tài liệu PDF an toàn, khép kín và chuyên nghiệp.

2. Tổng quan về giải pháp: Stirling-PDF Multi-User và Authentik

Stirling-PDF là gì?

Stirling-PDF là một ứng dụng web mã nguồn mở mạnh mẽ, cho phép thực hiện hầu hết các thao tác xử lý file PDF thông dụng mà không cần cài đặt phần mềm máy khách. Phiên bản Multi-User (Đa người dùng) mới mang đến khả năng phân quyền, quản lý tài khoản và lưu trữ cấu hình riêng biệt cho từng nhân sự trong phòng kế toán.

Vai trò của Authentik OIDC trong hệ thống

Để đảm bảo chỉ những nhân sự được ủy quyền mới có quyền truy cập vào hệ thống xử lý PDF, chúng ta cần một giải pháp xác thực mạnh mẽ. Authentik là một hệ thống quản lý định danh (Identity Provider - IdP) mã nguồn mở. Việc tích hợp qua giao thức OpenID Connect (OIDC) giúp đồng bộ tài khoản kế toán, áp dụng chính sách bảo mật nhiều lớp (MFA/2FA) và mang lại trải nghiệm Đăng nhập một lần (SSO) mượt mà.

3. Chuẩn bị hạ tầng VPS và tài nguyên hệ thống

Để hệ thống vận hành ổn định cho một phòng kế toán từ 5 đến 20 nhân sự, cấu hình VPS khuyến nghị cần đáp ứng:

  • CPU: Tối thiểu 2 vCPU (Khuyến nghị 4 vCPU nếu tần suất xử lý file lớn liên tục).
  • RAM: Tối thiểu 4GB (Stirling-PDF cần RAM để xử lý các tác vụ OCR - nhận diện chữ viết và render file nặng).
  • Dung lượng ổ cứng: 40GB SSD/NVMe trở lên.
  • Hệ điều hành: Ubuntu Server 22.04 LTS hoặc 24.04 LTS.
  • Tên miền (Domain): Đã trỏ sẵn các bản ghi A về IP của VPS (Ví dụ: pdf.congty.com và auth.congty.com).
Lưu ý: Hệ thống bắt buộc phải cấu hình SSL (HTTPS) để mã hóa đường truyền dữ liệu tài liệu giữa máy tính kế toán và VPS.

4. Hướng dẫn từng bước triển khai kỹ thuật

Bước 1: Cài đặt Docker và Docker Compose

Truy cập vào VPS qua SSH và cập nhật hệ thống, sau đó cài đặt môi trường Docker:sudo apt update && sudo apt upgrade -y sudo apt install docker.io docker-compose -y

Bước 2: Cấu hình Authentik làm Identity Provider

Triển khai Authentik thông qua Docker Compose. Sau khi khởi tạo thành công giao diện Admin của Authentik (tại auth.congty.com), người quản trị cần tạo một Provider mới:

  1. Chọn Applications > Providers > Create.
  2. Chọn loại OAuth2/OpenID Connect Provider.
  3. Điền thông tin đặt tên (ví dụ: Stirling-PDF Provider).
  4. Cấu hình Redirect URIs chính xác theo định dạng của Stirling-PDF: [https://pdf.congty.com/login/oauth2/code/authentik](https://pdf.congty.com/login/oauth2/code/authentik).
  5. Lưu lại thông tin Client ID và Client Secret được cấp.

Tiếp theo, tạo một Application trong Authentik, liên kết nó với Provider vừa tạo và phân quyền cho nhóm người dùng thuộc phòng Kế toán.

Bước 3: Cấu hình và khởi chạy Stirling-PDF với Docker Compose

Tạo một thư mục dự án và file docker-compose.yml cho Stirling-PDF:

mkdir ~/stirling-pdf && cd ~/stirling-pdf
nano docker-compose.yml

Nội dung file cấu hình cần chú ý kích hoạt tính năng mã hóa, bảo mật hệ thống và điền các tham số OIDC nhận được từ Authentik:

version: '3.3'
services:
  stirling-pdf:
    image: frooodle/s-pdf:latest
    ports:
      - '8080:8080'
    volumes:
      - ./trainingData:/usr/share/tessdata
      - ./extraConfigs:/configs
      - ./logs:/logs
    environment:
      - DOCKER_ENABLE_SECURITY=true
      - SECURITY_ENABLE_LOGIN=true
      - SECURITY_OAUTH2_ENABLED=true
      - SECURITY_OAUTH2_CLIENT_ID=
      - SECURITY_OAUTH2_CLIENT_SECRET=
      - SECURITY_OAUTH2_ISSUER_URI=[https://auth.congty.com/application/o/stirling-pdf/](https://auth.congty.com/application/o/stirling-pdf/)
      - SECURITY_OAUTH2_CLIENT_NAME=Authentik SSO
      - SECURITY_OAUTH2_SCOPES=openid,profile,email

Khởi chạy container bằng lệnh: docker-compose up -d. Sau đó cấu hình Reverse Proxy (như Nginx hoặc Traefik) để cấp chứng chỉ SSL Let's Encrypt cho domain pdf.congty.com.

5. Quy trình vận hành và lợi ích thực tiễn cho phòng Kế toán

Sau khi hoàn tất cài đặt, quy trình làm việc của nhân viên kế toán sẽ thay đổi theo hướng chuyên nghiệp và an toàn hơn đáng kể:

  • Đăng nhập một chạm: Nhân viên truy cập pdf.congty.com, hệ thống tự động chuyển hướng qua giao diện Authentik. Nhân viên nhập tài khoản doanh nghiệp được cấp, xác thực 2FA trên điện thoại là có thể vào làm việc.
  • Xử lý dữ liệu tốc độ cao tại chỗ: Mọi thao tác nén file, ký số, chuyển đổi PDF sang Excel/Word đều được xử lý bằng tài nguyên của VPS doanh nghiệp, tốc độ phản hồi nhanh và hoàn toàn bảo mật.
  • Quản trị kiểm vết: Người quản trị hệ thống (IT Admin) có thể kiểm soát được thời gian truy cập của từng nhân sự thông qua nhật ký (logs) của Authentik, đảm bảo tính minh bạch và tuân thủ quy trình an toàn thông tin doanh nghiệp.

6. Kết luận

Việc tự chủ hạ tầng công nghệ bằng các giải pháp mã nguồn mở tinh gọn như Stirling-PDF và Authentik không chỉ giúp doanh nghiệp tối ưu hóa chi phí bản quyền phần mềm hàng năm, mà quan trọng hơn là bảo vệ tuyệt đối tài sản dữ liệu của phòng Kế toán. Đây là bước đi chiến lược, khẳng định sự chín muồi về mặt công nghệ và tư duy bảo mật của một doanh nghiệp hiện đại.