Sao lưu

Trong HiTechCloud, việc sao lưu có thể được cấu hình trực tiếp bởi người dùng panel, khác với các panel khác nơi sao lưu do quản trị viên quản lý.

Điều này giúp người dùng tự định nghĩa lịch sao lưu, chọn chính xác những gì cần sao lưu và chọn trong nhiều đích được hỗ trợ. Nhờ đó quản trị viên có ít việc phải quản lý hơn, còn người dùng được kiểm soát và linh hoạt hơn.

Đích sao lưu​

HiTechCloud hỗ trợ các đích sau:

• Lưu trữ S3 - AWS S3, Filebase, MinIO, v.v.
• WebDAV - Sao lưu từ xa bằng WebDAV.
• SSH - Sao lưu từ xa qua SSH tới một máy chủ khác.
• Azure - Sao lưu từ xa lên Azure Blob Storage.
• Dropbox - Sao lưu từ xa lên kho lưu trữ đám mây Dropbox.

Người dùng chọn đích từ trang Backups > Destinations.

Khi đã chọn đích sao lưu, các tuỳ chọn của nó có trên trang Backups > Settings.

SSH/SFTP​

S3​

WebDAV​

Azure​

Dropbox​

Thiết lập backend lưu trữ Dropbox:

1. Tạo một Ứng dụng Dropbox mới trong App Console
2. Mở Ứng dụng Dropbox mới của bạn và sao chép DROPBOX_APP_KEY và DROPBOX_APP_SECRET
3. Nhấn Permissions trong ứng dụng và bảo đảm các quyền sau đã được cấp (hoặc nhiều hơn):
   • files.metadata.write
   • files.metadata.read
   • files.content.write
   • files.content.read
4. Thay APPKEY trong https://www.dropbox.com/oauth2/authorize?client_id=APPKEY&token_access_type=offline&response_type=code bằng khoá ứng dụng ở bước 2
5. Truy cập URL và xác nhận quyền truy cập của ứng dụng. Việc này cho bạn một auth code -> hãy lưu nó ở đâu đó!
6. Thay AUTHCODE, APPKEY, APPSECRET tương ứng và thực hiện yêu cầu từ terminal của bạn:

   curl https://api.dropbox.com/oauth2/token \
   -d code=AUTHCODE \
   -d grant_type=authorization_code \
   -d client_id=APPKEY \
   -d client_secret=APPSECRET
   
7. Thực hiện yêu cầu. Bạn sẽ nhận một phản hồi định dạng JSON. Dùng giá trị của refresh_token cho thiết lập cuối cùng DROPBOX_REFRESH_TOKEN
8. Giờ bạn đã đặt DROPBOX_APP_KEY, DROPBOX_APP_SECRET và DROPBOX_REFRESH_TOKEN. Chúng không hết hạn.

Mã hoá​

Mã hoá sao lưu mặc định bị tắt và phải được Quản trị viên bật trước.

Tất cả các tuỳ chọn mã hoá loại trừ lẫn nhau. Hãy cung cấp một tuỳ chọn duy nhất cho sơ đồ mã hoá bạn chọn.

Xoay vòng​

Nguồn​

Theo mặc định, mọi thứ đều được sao lưu. Trong trường hợp bạn chỉ cần sao lưu một dữ liệu cụ thể, hãy đặt BACKUP_SOURCES. Trên trang Backups > Settings, mục này được hiển thị dưới dạng danh sách thả xuống với các tuỳ chọn sau:

Lịch​

Các bản sao lưu có thể chạy theo lịch cố định được định nghĩa bằng biểu thức cron. BACKUP_CRON_EXPRESSION được dùng để đặt lịch cho tác vụ sao lưu, một biểu thức cron biểu diễn một tập các thời điểm, dùng 5 hoặc 6 trường phân tách bằng dấu cách.

Giá trị trường Tháng và Ngày trong tuần không phân biệt hoa thường. "SUN", "Sun" và "sun" đều được chấp nhận. Hãy tham khảo các trang như crontab.guru để được trợ giúp.

Nếu không đặt giá trị nào, @daily sẽ được dùng, chạy mỗi ngày vào nửa đêm.

Nén​

Đặt tên​

Các tuỳ chọn ở đây có sẵn nhưng mặc định bị tắt và phải được Quản trị viên bật thủ công trước.

Loại trừ​

BACKUP_EXCLUDE_REGEXP - Khi có giá trị, mọi tệp trong BACKUP_SOURCES có đường dẫn đầy đủ khớp với biểu thức chính quy sẽ bị loại khỏi kho lưu. Có thể dùng biểu thức chính quy như trong thư viện chuẩn của Go. Ví dụ: \.log$.

Thông báo​

Thông báo (email, Slack, v.v.) có thể được gửi khi một lần chạy sao lưu kết thúc.

NOTIFICATION_URLS​

Cấu hình được cung cấp dưới dạng danh sách URL phân tách bằng dấu phẩy theo cách shoutrrr sử dụng

Email​

Định dạng URL:

smtp://username:password@host:port/?from=fromAddress&to=recipient1[,recipient2,...]

Các trường URL:

• Username – Tên người dùng máy chủ SMTP
  Mặc định: trống
  Phần URL: smtp://username:password@host:port/

• Password – Mật khẩu máy chủ SMTP hoặc giá trị băm (cho OAuth2)
  Mặc định: trống
  Phần URL: smtp://username:password@host:port/

• Host – Tên máy hoặc địa chỉ IP của máy chủ SMTP (Bắt buộc)
  Phần URL: smtp://username:password@host:port/

• Port – Cổng máy chủ SMTP
  Giá trị thường gặp: 25, 465, 587, 2525
  Mặc định: 25
  Phần URL: smtp://username:password@host:port/

Thuộc tính truy vấn/tham số:

Các thuộc tính có thể được cung cấp qua đối số params hoặc trực tiếp trong URL bằng ?key=value&key=value.

• FromAddress – Địa chỉ email dùng để gửi thư (Bắt buộc)
  Bí danh: from

• ToAddresses – Danh sách email người nhận phân tách bằng dấu phẩy (Bắt buộc)
  Bí danh: to

• Auth – Phương thức xác thực SMTP
  Mặc định: Unknown
  Giá trị có thể: None, Plain, CRAMMD5, Unknown, OAuth2

• ClientHost – Tên máy gửi tới máy chủ SMTP trong giai đoạn HELO
  Mặc định: localhost
  Đặt thành "auto" để dùng tên máy của hệ điều hành

• Encryption – Phương thức mã hoá
  Mặc định: Auto
  Giá trị có thể: None, ExplicitTLS, ImplicitTLS, Auto

• FromName – Tên người gửi
  Mặc định: trống

• Subject – Dòng tiêu đề của email
  Mặc định: Shoutrrr Notification
  Bí danh: title

• UseHTML – Thư có ở định dạng HTML hay không
  Mặc định: ❌ Không

• UseStartTLS – Có dùng mã hoá StartTLS hay không
  Mặc định: ✔ Có
  Bí danh: starttls

Bark​

Các trường URL:

• DeviceKey – Khoá của từng thiết bị (Bắt buộc)
  Phần URL: bark://:devicekey@host/path

• Host – Tên máy và cổng của máy chủ (Bắt buộc)
  Phần URL: bark://:devicekey@host/path

• Path – Đường dẫn máy chủ
  Mặc định: /
  Phần URL: bark://:devicekey@host/path

Thuộc tính truy vấn/tham số:

Các thuộc tính có thể được cung cấp qua đối số params, hoặc qua URL bằng ?key=value&key=value v.v.

• Badge – Số hiển thị cạnh biểu tượng ứng dụng
  Mặc định: 0

• Category – Trường dành riêng, chưa dùng
  Mặc định: trống

• Copy – Giá trị cần sao chép
  Mặc định: trống

• Group – Nhóm của thông báo
  Mặc định: trống

• Icon – URL của biểu tượng, chỉ có trên iOS 15 trở lên
  Mặc định: trống

• Scheme – Giao thức máy chủ, http hoặc https
  Mặc định: https

• Sound – Giá trị từ Bark Sounds
  Mặc định: trống

• Title – Tiêu đề thông báo, người gửi có thể đặt tuỳ chọn
  Mặc định: trống

• URL – URL sẽ mở khi nhấn vào thông báo
  Mặc định: trống

Discord​

Định dạng URL:

discord://token@webhookid

Các trường URL:

• Token – (Bắt buộc)
  Phần URL: discord://token@webhookid/

• WebhookID – (Bắt buộc)
  Phần URL: discord://token@webhookid/

Thuộc tính truy vấn/tham số:

Các thuộc tính có thể được cung cấp qua đối số params, hoặc qua URL bằng ?key=value&key=value v.v.

• Avatar – Ghi đè ảnh đại diện mặc định của webhook bằng URL đã chỉ định
  Mặc định: trống
  Bí danh: avatarurl

• Color – Màu của viền trái cho tin nhắn thường
  Mặc định: 0x50D9ff

• ColorDebug – Màu của viền trái cho tin nhắn gỡ lỗi
  Mặc định: 0x7b00ab

• ColorError – Màu của viền trái cho tin nhắn lỗi
  Mặc định: 0xd60510

• ColorInfo – Màu của viền trái cho tin nhắn thông tin
  Mặc định: 0x2488ff

• ColorWarn – Màu của viền trái cho tin nhắn cảnh báo
  Mặc định: 0xffc441

• JSON – Có gửi toàn bộ tin nhắn dưới dạng payload JSON thay vì dùng làm trường content hay không
  Mặc định: ❌ Không

• SplitLines – Có gửi mỗi dòng thành một mục nhúng riêng hay không
  Mặc định: ✔ Có

• Title
  Mặc định: trống

• Username – Ghi đè tên người dùng mặc định của webhook
  Mặc định: trống

Tạo một Webhook trong Discord:

1. Mở cài đặt kênh của bạn bằng cách nhấn biểu tượng bánh răng cạnh tên kênh.
2. Ở menu bên trái, nhấn Integrations.
   
3. Ở bên phải, nhấn Create Webhook.
   
4. Đặt tên, kênh và biểu tượng theo ý bạn, rồi nhấn Copy Webhook URL.
   
5. Nhấn Save Changes. 6 Định dạng URL dịch vụ:

   https://discord.com/api/webhooks/693853386302554172/W3dE2OZz4C13_4z_uHfDOoC7BqTW288s-z1ykqI0iJnY_HjRqMGO8Sc7YDqvf_KVKjhJ
                                    └────────────────┘ └──────────────────────────────────────────────────────────────────┘
                                        webhook id                                    token
   
   discord://W3dE2OZz4C13_4z_uHfDOoC7BqTW288s-z1ykqI0iJnY_HjRqMGO8Sc7YDqvf_KVKjhJ@693853386302554172
             └──────────────────────────────────────────────────────────────────┘ └────────────────┘
                                             token                                    webhook id
   

NOTIFICATION_LEVEL​

Theo mặc định, thông báo chỉ được gửi khi một lần chạy sao lưu thất bại. Để nhận thông báo cho mọi lần chạy, hãy đặt NOTIFICATION_LEVEL thành info thay vì giá trị mặc định error.

Kích hoạt một bản sao lưu​

Bạn có thể kích hoạt một bản sao lưu thủ công bất cứ lúc nào, bất kể cài đặt lịch. Để làm vậy, hãy bảo đảm tính năng Docker đã được bật. Sau đó:

1. Vào Containers > Terminal.
2. Chọn container Backup.
3. Trong terminal, gõ lệnh sau và nhấn Enter:

backup

Khôi phục & Tải xuống​

Trang Restore & Download (/backups/list) cho phép bạn duyệt các tệp sao lưu đã có trên đích đã cấu hình, khôi phục chúng về tài khoản của bạn, hoặc tải chúng về máy tính. Hiện chỉ hoạt động với đích SSH/SFTP.

1. Nhấn Reindex Destination để kết nối tới đích từ xa và liệt kê các kho sao lưu có sẵn. Việc lập chỉ mục lại chạy ở chế độ nền và trang tự cập nhật khi hoàn tất.

2. Mỗi bản sao lưu đã lập chỉ mục hiển thị tên tệp, nội dung phát hiện được (html, vhosts, mail, mysql, postgres, crons) và các cơ sở dữ liệu tìm thấy bên trong.

3. Nhấn Restore trên một bản sao lưu để mở hộp thoại khôi phục, rồi chọn những gì cần khôi phục:

   • Everything – khôi phục tệp và mọi cơ sở dữ liệu từ kho lưu.
   • Specific database only – khôi phục một cơ sở dữ liệu được chọn từ kho lưu (chỉ hiện khi kho lưu có cơ sở dữ liệu).
   • Files only (no databases) – khôi phục tệp website, vhost, thư và cron job mà không đụng tới cơ sở dữ liệu nào.

   Khôi phục sẽ ghi đè dữ liệu hiện có và không thể hoàn tác.

4. Nhấn Download trên một bản sao lưu để lấy kho lưu từ đích và tải về trình duyệt của bạn.

Khắc phục sự cố​

Văn bản lỗi dưới đây là đầu ra nhật ký của chính container sao lưu (xem phần ghi nguồn ở trên), nên chỉ xuất hiện trên stack container.

Lỗi *error copying archive: ssh.(sshStorage).Copy: error creating file: file does not exist cho biết thư mục đã cấu hình không tồn tại trên đích:

time=2025-07-22T11:21:05.117Z level=ERROR msg="Fatal error running command: file does not exist" error="main.(*command).runAsCommand: error running script: main.runScript.func4: error running script: main.(*script).copyArchive: error copying archive: ssh.(*sshStorage).Copy: error creating file: file does not exist"