📑 Mục lục

• 🤔 Recyclarr là gì?
• 🛠️ Thiết lập cấu hình Docker Compose
• 📦 Cấu hình cơ bản (recyclarr.yml)
• 💾 Tùy chỉnh Recyclarr
• ✅ Kết luận
• ❓ Câu hỏi thường gặp

🤔 Recyclarr là gì? (và tại sao nên chạy trong Docker)

Recyclarr là một công cụ mã nguồn mở giúp đồng bộ hóa cài đặt Sonarr và Radarr của bạn với những khuyến nghị mới nhất từ TRaSH-Guides. Thay vì phải sao chép thủ công các hồ sơ chất lượng, định dạng tùy chỉnh và tiêu chuẩn đặt tên, Recyclarr sẽ tự động lấy các cấu hình mới nhất từ TRaSH-Guides và áp dụng chúng vào ứng dụng của bạn. Điều này có nghĩa là bạn sẽ tiết kiệm thời gian điều chỉnh cài đặt và có thêm thời gian để tận hưởng thư viện media sạch sẽ và nhất quán hơn.

Cập nhật diễn ra trên hai cấp độ:

• Công cụ: được cập nhật bởi dự án Recyclarr (dễ dàng kéo phiên bản mới thông qua Docker).
• Cấu hình: được lấy từ TRaSH-Guides mỗi lần bạn thực hiện đồng bộ, giúp bạn luôn có được những phương pháp tốt nhất từ cộng đồng.

Chạy Recyclarr trong Docker càng làm cho việc này trở nên dễ dàng hơn:

• Triển khai bằng lệnh docker compose up -d
• Cập nhật bằng cách kéo hình ảnh mới nhất và khởi động lại container
• Giữ mọi thứ cách ly và có thể tái tạo, giống như phần còn lại của stack media của bạn

Đối với những ai đã sử dụng Docker cho Plex/Jellyfin, Sonarr, Radarr hoặc các ứng dụng homelab khác, Recyclarr rất dễ dàng tích hợp mà không cần nhiều nỗ lực.

🛠️ Thiết lập cấu hình Docker Compose

1. Tạo thư mục cấu hình

Đầu tiên, tạo một thư mục cho cấu hình của Recyclarr. Đây là nơi file recyclarr.yml của bạn sẽ được lưu:

mkdir recyclarr

2. Thêm docker-compose.yml

Tạo một file docker-compose.yml trong cùng thư mục với nội dung như sau:

version: "3.9"

networks:
  media-server:
    external: true

services:
  recyclarr:
    image: ghcr.io/recyclarr/recyclarr:latest
    container_name: recyclarr
    networks:
      - media-server
    environment:
      - TZ=Europe/Amsterdam
    volumes:
      - ./config:/config
    restart: unless-stopped

Trong ví dụ này, tôi đã chọn sử dụng một mạng tùy chỉnh. Đây là cách tôi khuyến nghị nếu Radarr và Sonarr chạy trong một file docker-compose.yml khác, vì mỗi file Compose sẽ tạo ra một mạng riêng tư mặc định. Các container trong các file khác nhau sẽ không thể nhìn thấy nhau trừ khi bạn gán chúng vào một mạng bên ngoài chung.

Bây giờ, tạo mạng đó (nếu bạn chưa làm):

docker network create media-server

Sau đó, kết nối Sonarr, Radarr và Recyclarr với nó.

Khởi động recyclarr

Khởi động với:

docker compose up -d

Điều này sẽ khởi động Recyclarr và tự động tạo thư mục ./config trên máy chủ của bạn (nếu nó chưa tồn tại). Bên trong thư mục đó, bạn sẽ thêm file cấu hình recyclarr.yml trong bước tiếp theo.

📦 Cấu hình cơ bản (recyclarr.yml)

Cách dễ nhất để bắt đầu với Recyclarr là sử dụng các file cấu hình đã được xây dựng sẵn. Chúng đến trực tiếp từ dự án Recyclarr và được căn chỉnh với TRaSH-Guides. Đối với hầu hết các thiết lập, các cấu hình này “chỉ cần hoạt động” với ít nỗ lực.

Bạn có thể tìm thấy chúng ở đây:

• Cấu hình đã được xây dựng sẵn (Tài liệu Recyclarr)
• Kho lưu trữ mẫu cấu hình (GitHub)

Ví dụ về cấu hình

Đặt file này vào ./recyclarr/recyclarr.yml:

radarr: 
  remux-web-1080p:
    base_url: http://radarr:7878
    api_key: YOUR_RADARR_API_KEY
    include:
      - template: radarr-quality-definition-movie
      - template: radarr-quality-profile-remux-web-1080p
      - template: radarr-custom-formats-remux-web-1080p

sonarr:
  web-1080p-v4:
    base_url: http://sonarr:8989
    api_key: YOUR_SONARR_API_KEY
    include:
      - template: sonarr-quality-definition-series
      - template: sonarr-v4-quality-profile-web-1080p
      - template: sonarr-v4-custom-formats-web-1080p

Cách các mẫu hoạt động

Mỗi dòng include: sẽ kéo vào một khối cài đặt được xây dựng sẵn. Ví dụ:

• radarr-quality-profile-remux-web-1080p → tạo một hồ sơ chất lượng cho Remux + WEB 1080p.
• radarr-custom-formats-remux-web-1080p → áp dụng các định dạng tùy chỉnh và điểm số theo đúng TRaSH-Guides.

Bạn không cần phải định nghĩa điểm số hay định dạng tùy chỉnh của riêng mình, Recyclarr sẽ lấy các quy tắc mới nhất từ TRaSH-Guides và áp dụng chúng vào hồ sơ của bạn.

API keys

Recyclarr cần các API key để giao tiếp với ứng dụng của bạn:

• Sonarr → Cài đặt → Chung → Bảo mật → API Key
• Radarr → Cài đặt → Chung → Bảo mật → API Key

Sao chép các key và dán chúng vào cấu hình của bạn.

Đồng bộ hóa Recyclarr

Khi file recyclarr.yml của bạn đã sẵn sàng, thực hiện đồng bộ:

docker compose exec recyclarr recyclarr sync

Điều này sẽ kết nối với Sonarr và Radarr, cập nhật các hồ sơ chất lượng và áp dụng các định dạng tùy chỉnh từ TRaSH-Guides. Khi container đang chạy với docker compose up -d, nó sẽ tự động đồng bộ theo lịch trình (hằng ngày theo mặc định), vì vậy bạn không cần phải kích hoạt nó thủ công. Nếu bạn thích chạy một lần, thêm cờ --rm để container sẽ bị xóa sau khi đồng bộ hoàn tất.

Sau khi đồng bộ, bạn sẽ thấy các hồ sơ chất lượng mới và các định dạng tùy chỉnh bên trong Radarr và Sonarr, được tạo tự động và liên kết với TRaSH-Guides.

Và vậy là xong, vào thời điểm này, Recyclarr đã sẵn sàng hoạt động và các hồ sơ của bạn đã sẵn sàng để sử dụng! 🎉

💾 Tùy chỉnh Recyclarr

Các cấu hình đã được xây dựng sẵn được thiết kế để đơn giản và có quan điểm. Ví dụ, các hồ sơ Radarr thường chỉ bao gồm hai chất lượng (ví dụ: Remux và WEB). Điều này hoàn toàn ổn nếu bạn muốn giữ mọi thứ tối giản, nhưng thực tế nhiều người thích bao gồm thêm nhiều tùy chọn (Blu-ray, HDTV, v.v.) hoặc thêm các quy tắc riêng của họ.

Bạn có thể làm điều này bằng cách mở rộng các mẫu đã được xây dựng sẵn với cài đặt của riêng bạn.

Ví dụ: thêm chất lượng và định dạng tùy chỉnh

radarr:
  remux-web-1080p:
    base_url: http://radarr:7878
    api_key: YOUR_RADARR_API_KEY
    include:
      - template: radarr-quality-definition-movie
      - template: radarr-quality-profile-remux-web-1080p
      - template: radarr-custom-formats-remux-web-1080p

    quality_profiles:
      - name: Remux + WEB 1080p
        qualities:
          - name: Remux-1080p
          - name: WEB 1080p
            qualities:
              - WEBDL-1080p
              - WEBRip-1080p
          - name: Bluray-1080p
          - name: HDTV-1080p

    custom_formats:
      - trash_ids:
          - 90a6f9a284dff5103f6346090e6280c8
        assign_scores_to:
          - name: Remux + WEB 1080p
            score: -100000

Trong ví dụ này:

• Chúng ta ghi đè hồ sơ chất lượng để thêm nhiều chất lượng hơn ngoài hai mặc định từ mẫu (Blu-ray và HDTV bên cạnh Remux/WEB).
• Chúng ta thêm một định dạng tùy chỉnh cho “Low Quality releases” và áp dụng nó vào cùng một hồ sơ, vì vậy Radarr sẽ tránh không tải xuống những bản đó.

Lưu ý: Nếu bạn đã có một định dạng tùy chỉnh với cùng tên trong Radarr/Sonarr, Recyclarr sẽ bỏ qua việc cập nhật nó. Để đảm bảo các cài đặt mới được áp dụng, hãy xóa định dạng tùy chỉnh hiện có trước và sau đó thực hiện đồng bộ.

Danh sách đầy đủ các TRaSH IDs (định dạng tùy chỉnh bạn có thể thêm) có thể được tìm thấy ở đây:

• Định dạng tùy chỉnh TRaSH-Guides Radarr
• Định dạng tùy chỉnh TRaSH-Guides Sonarr

Đối với hầu hết người dùng, các mặc định từ các mẫu là đủ. Nhưng nếu bạn muốn kiểm soát thêm về các chất lượng nào được cho phép, hoặc bạn muốn lọc ra một số loại phát hành nhất định, việc tùy chỉnh này sẽ mang lại cho bạn sự linh hoạt để điều chỉnh mọi thứ theo sở thích của bạn.

Hãy chắc chắn rằng sau mỗi thay đổi, bạn chạy docker-compose exec recyclarr recyclarr sync

✅ Kết luận

Thiết lập các hồ sơ chất lượng và định dạng tùy chỉnh trong Sonarr và Radarr có thể rất tốn thời gian, đặc biệt nếu bạn muốn tuân theo tất cả các khuyến nghị từ TRaSH-Guides. Recyclarr giúp bạn gỡ bỏ toàn bộ quy trình này. Chỉ với một lần đồng bộ, nó tạo ra các hồ sơ cho bạn, áp dụng các định dạng tùy chỉnh phù hợp và giữ mọi thứ được cập nhật khi TRaSH-Guides phát triển.

Chạy nó trong Docker làm cho việc thiết lập trở nên dễ dàng hơn, không cần cài đặt thủ công, cập nhật đơn giản và nó chỉ chạy lặng lẽ ở phía sau. Thay vì dành thời gian điều chỉnh cài đặt, bạn có được một máy chủ media luôn phù hợp với các phương pháp tốt nhất từ cộng đồng, mà không cần thêm công việc.

Cảm ơn bạn đã đọc!

Bài viết ban đầu được đăng trên trang của tôi: ZeroToHomeLab. Tôi sẽ đăng các cập nhật ở đó nếu có bất kỳ thay đổi nào.