Sign inSign up

cloverdefa/hath

By cloverdefa

•Updated 3 days ago

H@H Client

Image
Networking
3

50K+

cloverdefa/hath repository overview

⁠hath-docker

hath-docker 在Docker容器中執行H@H客戶端

H@H客戶端版本 : 1.6.5

⁠Usage

使用docker來運作容器:

docker run \
  --name hath \
  --net host \
  --user 1000:1000 \
  -v /本地cache路徑:/hath/cache \
  -v /本地data路徑:/hath/data \
  -v /本地download路徑:/hath/download \
  -v /本地log路徑:/hath/log \
  -v /本地tmp路徑:/hath/tmp \
  -e HATH_CLIENT_ID=輸入你的HATH_ID \
  -e HATH_CLIENT_KEY=輸入你的HATH_KEY \
  -e UMASK=027 \
  cloverdefa/hath:latest

使用docker-compose來運作容器:

⁠compose.yaml範例
---
services:
  hath:
    container_name: "hath"
    image: "cloverdefa/hath:latest"
    restart: "unless-stopped"
    ports:
      - "12345:12345" # 修改為HATH設定PORT
    user: "1000:1000" # 請以機器當下的UID:GID值取代
    volumes:
      - "./cache:/hath/cache"
      - "./data:/hath/data"
      - "./download:/hath/download"
      - "./log:/hath/log"
      - "./tmp:/hath/tmp"
    environment:
      # 編輯同路徑資料夾下的.env檔案來設定ID及KEY
      HATH_CLIENT_ID: "${HATH_CLIENT_ID}"
      HATH_CLIENT_KEY: "${HATH_CLIENT_KEY}"
      UMASK: "027"
      TZ: "Asia/Taipei" # 設定主機所在時區
    env_file: "./.env"

建立.env檔案存放ID及KEY

⁠.env(範例)
HATH_CLIENT_ID=ID       # 修改ID為你的 H@H client id
HATH_CLIENT_KEY=KEY     # 修改KEY為你的 H@H client key

變更.env檔案權限

chmod 600 .env

⁠執行身份（UID/GID）說明

容器內建有一個 hath（uid/gid 1000）使用者，Dockerfile 預設以此身份執行。

但透過 docker-compose 啟動時，compose.yaml 內的 user: "1000:1000" 會覆蓋這個預設值， 實際執行身份直接由這個欄位的值決定，與 image 內建的 hath 使用者無關（即使數值相同）。

  • 設定為 1000:1000：等同於使用 image 內建的 hath。
  • 設定其他 UID/GID（例如對齊 host 上某個既有使用者）：容器內程式會以該身份執行， 此時掛載到容器的 volume 目錄擁有者也必須是同一組 UID/GID（詳見下方「Volume 目錄權限」章節）， 否則會遇到 Permission denied。

若不透過 docker-compose、改用 docker run 且未加 --user 參數，才會真正使用 image 內建的 hath。

若需要在不同機器上部署且 UID/GID 不同，建議直接修改 compose.yaml 內的 user 欄位。

⁠Volume 目錄權限

compose.yaml 範例使用 bind mount（如 ./cache:/hath/cache）將 host 端目錄 掛載進容器。這些目錄的實際存取權限取決於 host 端目錄本身的擁有者，與容器內部設定無關。

啟動前請確保 host 端目錄的擁有者，與 compose.yaml 內 user（UID:GID）一致，例如：

mkdir -p cache data download log tmp
sudo chown -R 1000:1000 cache data download log tmp

若擁有者不一致，容器會因為沒有寫入權限而無法啟動，run.sh 啟動時會印出對應錯誤提示。

⁠Github Repositories

https://github.com/cloverdefa/hath-docker⁠

⁠貢獻

歡迎提交 Issue 或 Pull Request！請遵循以下步驟：

  1. Fork 此專案。
  2. 建立一個新分支： 
    git checkout -b feature/你的功能名稱
  3. 提交更改並推送到你的分支： 
    git commit -m "說明你的修改內容"
git push origin feature/你的功能名稱
  4. 至 GitHub 發送 Pull Request。

⁠授權

此專案基於 MIT 授權條款，詳見 MIT License⁠ 授權條款。

Tag summary

Content type

Image

Digest

sha256:41060aa0f…

Size

46.1 MB

Last updated

3 days ago

docker pull cloverdefa/hath