Nhảy tới nội dung

Đồng bộ hình ảnh với kho lưu trữ tương thích S3

S3 là một dịch vụ lưu trữ đám mây phổ biến, bạn có thể sử dụng dịch vụ này để lưu trữ hình ảnh. OpenNotas hiện đang hỗ trợ các nhà cung cấp dịch vụ lưu trữ tương thích S3.

Lưu ý rằng tính năng đồng bộ hình ảnh chỉ mới hỗ trợ cho trình soạn thảo Milkdown. Kể từ phiên bản 1.3.0 trở đi, các hình ảnh nhập vào ứng dụng sẽ được đồng bộ nếu đồng bộ được bật. Hãy nhớ đảm bảo dung lượng lưu trữ của kho lưu trữ đủ lớn để chứa các hình ảnh được nhập vào ứng dụng.

Hướng dẫn lấy cấu hình​

Tuỳ thuộc vào nhà cung cấp dịch vụ lưu trữ, bạn có thể tham khảo tài liệu hướng dẫn của họ để lấy cấu hình. Mấu chốt là bạn cần có được URL của kho lưu trữ và mã thông báo (access key id và secret access key) để đồng bộ hình ảnh.

Tham khảo các nhà cung cấp dịch vụ lưu trữ hình ảnh tương thích S3:

Một số nhà cung cấp dịch vụ miễn phí với mức giới hạn dung lượng lưu trữ như:

Bạn cũng có thể tự triển khai kho lưu trữ S3 cho riêng mình bằng cách sử dụng công cụ mã nguồn mở như MinIO hoặc Ceph.

Nhìn chung các bước diễn ra như sau:

  1. Tạo kho lưu trữ trên nhà cung cấp dịch vụ lưu trữ.
  2. Tạo một đối tượng (bucket) trong kho lưu trữ.
  3. Tạo một token trong kho lưu trữ.
  4. Nhập cấu hình vào ứng dụng.
  5. Bấm vào nút "Test Connection" để kiểm tra kết nối. Nếu thành công, bạn sẽ nhận được thông báo "Connected". Nếu không, hãy kiểm tra lại cấu hình và thử lại.

Cấu hình trong ứng dụng​

Vào Cài đặt > Đồng bộ > Bật chức năng đồng bộ hình ảnh, nhập các thông tin cần thiết.

Lưu ý rằng bạn cần tự triển khai Worker Proxy để đồng bộ hình ảnh. Mã nguồn của Worker Proxy có thể được tìm thấy ở đây. Worker Proxy được viết cho Cloudflare Workers vì nó miễn phí và phục vụ mục đích cá nhân tương đối tốt. Nếu không triển khai Worker Proxy, bạn sẽ dùng máy chủ Proxy mặc định mà OpenNotas cung cấp. Chúng tôi cam kết không ghi lại bất kỳ thông tin xác thực nào. Tuy nhiên bạn sẽ phải dùng chung với những người khác và đôi khi hết hạn mức miễn phí trong ngày (100 000 requests/day). Nhìn chung chúng tôi khuyên bạn nên tự triển khai Worker Proxy để đảm bảo tốc độ và bảo mật.

Hướng dẫn triển khai Worker Proxy​

Trước tiên bạn cần tạo một tài khoản Cloudflare miễn phí.

1, Clone repository:

git clone https://github.com/tonghoai/opennotas.git

2, Di chuyển vào thư mục worker/worker-proxy:

cd opennotas/worker/worker-proxy

3, Cài đặt gói phụ thuộc:

Yêu cầu: Node.js version >= 18. 
npm install

4, Triển khai lên Cloudflare Workers:

npm run deploy

URL của Worker Proxy sẽ được hiển thị trong console. Bạn cần lưu lại URL này để sử dụng trong cấu hình ứng dụng.