diff --git a/README.md b/README.md index 88747f8..d4b6b6d 100644 --- a/README.md +++ b/README.md @@ -226,33 +226,44 @@ cd ~/MediaStationGo mkdir -p data cache media downloads ``` -4. 创建 `.env`，按需修改媒体库和下载目录： +4. 创建 `.env`，按你的 NAS 路径填写。推荐使用“NAS 绝对路径直读模式”，网页里就可以直接填写 `/vol1/...` 原始路径： ```bash cat > .env <<'EOF' -MEDIASTATION_IMAGE_TAG=latest +# 固定版本；需要升级时改成新的 MediaStationGo-vX.Y.Z 后执行 docker compose pull && docker compose up -d +MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.8 MEDIASTATION_HTTP_PORT=18080 + +# 程序数据和缓存建议放在 MediaStationGo 部署目录下，便于备份和迁移。 MEDIASTATION_DATA_DIR=./data MEDIASTATION_CACHE_DIR=./cache -# 如果只想使用部署目录下的 media/downloads 子目录，可以保留下面两行。 -# 如果媒体和下载目录已经在 NAS 绝对路径中，请改成 /vol1/...、/volume1/... 或 /mnt/...。 -MEDIASTATION_MEDIA_DIR=./media -MEDIASTATION_DOWNLOAD_DIR=./downloads + +# NAS / 飞牛直读模式：左侧宿主机路径与右侧容器路径保持一致。 +# 这样添加媒体库时直接填写 /vol1/1000/Docker/moviepilot-v2/media/电视剧/国产剧。 +MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_MEDIA_CONTAINER_DIR=/vol1/1000/Docker/moviepilot-v2/media + +# 下载目录同样保持一致，方便 qBittorrent、MediaStationGo、站点订阅共用同一个保存路径。 +MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/vol1/1000/qBittorrent/downloads + TZ=Asia/Shanghai PUID=1000 PGID=1000 EOF ``` -如果你的媒体文件已经在 NAS 路径中，必须改成宿主机绝对路径，例如： +> 重点：不要写 `./vol1/1000/...`。`./vol1` 代表当前部署目录下的 `vol1` 子目录，最终会变成类似 `/vol1/1000/Docker/MediaStationGo/vol1/...` 这种错误路径。正确写法必须以 `/vol1/...` 开头。 + +如果你只是本地测试，没有现成 NAS 媒体目录，也可以改回部署目录下的测试目录： ```env -MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media -MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +MEDIASTATION_MEDIA_DIR=./media +MEDIASTATION_MEDIA_CONTAINER_DIR=/media +MEDIASTATION_DOWNLOAD_DIR=./downloads +MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/downloads ``` -> 重点：不要写 `./vol1/1000/...`。`./vol1` 代表当前部署目录下的 `vol1` 子目录，最终会变成类似 `/vol1/1000/Docker/MediaStationGo/vol1/...` 这种错误路径。正确写法必须以 `/vol1/...` 开头。 - 5. 下载默认 `docker-compose.yml`： ```bash @@ -470,19 +481,24 @@ docker compose up -d ### 固定版本部署 -建议生产环境固定版本，避免 `latest` 自动变化： +建议生产环境固定版本，避免 `latest` 自动变化。NAS 直读推荐 `.env`： ```bash cat > .env <<'EOF' MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.8 MEDIASTATION_HTTP_PORT=18080 -MEDIASTATION_MEDIA_DIR=/mnt/nas/media -MEDIASTATION_DOWNLOAD_DIR=/mnt/nas/downloads MEDIASTATION_DATA_DIR=./data MEDIASTATION_CACHE_DIR=./cache +MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_MEDIA_CONTAINER_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/vol1/1000/qBittorrent/downloads TZ=Asia/Shanghai +PUID=1000 +PGID=1000 EOF +docker compose pull docker compose up -d ``` @@ -520,6 +536,16 @@ MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/vol1/1000/qBittorrent/downloads 这样添加媒体库时就可以直接填写 `/vol1/1000/Docker/moviepilot-v2/media/电视剧/国产剧`。 +推荐添加媒体库路径示例： + +| 媒体库 | 页面填写路径 | 类型 | +| --- | --- | --- | +| 华语电影 / 外语电影 / 动画电影 | `/vol1/1000/Docker/moviepilot-v2/media/电影` | 电影 | +| 国产剧 / 欧美剧 / 日韩剧 / 国漫 / 日番 / 综艺 | `/vol1/1000/Docker/moviepilot-v2/media/电视剧` | 电视剧 / 动漫 / 综艺 | +| 下载根目录 | `/vol1/1000/qBittorrent/downloads` | 下载器保存路径 | + +如果你只想添加更细的分类目录，也可以填 `/vol1/1000/Docker/moviepilot-v2/media/电视剧/国产剧`；系统会直接扫描这个目录，不会复制、不搬家。 + > 安全策略：扫描和播放只读取原目录；“整理整个库”不会再搬动已经位于媒体库目录内的文件，避免本地 NFO、海报、字幕等元数据被迁移后丢失。下载完成后的自动整理仍然默认关闭，只有你手动打开后才会移动下载目录中的新文件。 如果 compose 中这样挂载： diff --git a/README_EN.md b/README_EN.md index 6520028..4e969ca 100644 --- a/README_EN.md +++ b/README_EN.md @@ -224,33 +224,35 @@ cd ~/MediaStationGo mkdir -p data cache media downloads ``` -4. Create `.env` and adjust paths as needed: +4. Create `.env`. For NAS deployments, the recommended mode is mapping the host absolute path to the exact same container path, so the web UI can use `/vol1/...` directly: ```bash cat > .env <<'EOF' -MEDIASTATION_IMAGE_TAG=latest +MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.8 MEDIASTATION_HTTP_PORT=18080 MEDIASTATION_DATA_DIR=./data MEDIASTATION_CACHE_DIR=./cache -# Keep the following two lines only if you want to use media/downloads under the deploy directory. -# For existing NAS folders, use absolute paths such as /vol1/..., /volume1/..., or /mnt/.... -MEDIASTATION_MEDIA_DIR=./media -MEDIASTATION_DOWNLOAD_DIR=./downloads +MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_MEDIA_CONTAINER_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/vol1/1000/qBittorrent/downloads TZ=Asia/Shanghai PUID=1000 PGID=1000 EOF ``` -For an existing NAS media folder, use absolute host paths, for example: +> Important: do not write `./vol1/1000/...`. `./vol1` means a `vol1` subdirectory under the current compose project, which can become a wrong path such as `/vol1/1000/Docker/MediaStationGo/vol1/...`. Correct NAS paths must start with `/vol1/...`. + +For local testing without existing NAS folders, use the deploy-directory mounts instead: ```env -MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media -MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +MEDIASTATION_MEDIA_DIR=./media +MEDIASTATION_MEDIA_CONTAINER_DIR=/media +MEDIASTATION_DOWNLOAD_DIR=./downloads +MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/downloads ``` -> Important: do not write `./vol1/1000/...`. `./vol1` means a `vol1` subdirectory under the current compose project, which can become a wrong path such as `/vol1/1000/Docker/MediaStationGo/vol1/...`. Correct NAS paths must start with `/vol1/...`. - 5. Download the default compose file: ```bash @@ -316,19 +318,24 @@ docker compose up -d ### Pin a Release Version -For production, pin a specific release tag instead of using `latest`: +For production, pin a specific release tag instead of using `latest`. Recommended NAS `.env`: ```bash cat > .env <<'EOF' MEDIASTATION_IMAGE_TAG=MediaStationGo-v0.0.8 MEDIASTATION_HTTP_PORT=18080 -MEDIASTATION_MEDIA_DIR=/mnt/nas/media -MEDIASTATION_DOWNLOAD_DIR=/mnt/nas/downloads MEDIASTATION_DATA_DIR=./data MEDIASTATION_CACHE_DIR=./cache +MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_MEDIA_CONTAINER_DIR=/vol1/1000/Docker/moviepilot-v2/media +MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/vol1/1000/qBittorrent/downloads TZ=Asia/Shanghai +PUID=1000 +PGID=1000 EOF +docker compose pull docker compose up -d ``` diff --git a/docker-compose.yml b/docker-compose.yml index 9ce5848..de584ea 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -20,11 +20,23 @@ # /media 媒体库只读挂载目录。网页中添加媒体库时填写容器内路径，例如 /media/Movies。 # /downloads 下载目录。下载器保存路径建议填写容器内路径，例如 /downloads/Movies。 # -# 宿主机路径建议： +# NAS / 飞牛推荐直读模式： +# 如果你希望网页里直接填写 NAS 原始路径，例如 +# /vol1/1000/Docker/moviepilot-v2/media/电视剧/国产剧， +# 请在 .env 中把宿主机路径和容器路径设置成完全相同： +# +# MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media +# MEDIASTATION_MEDIA_CONTAINER_DIR=/vol1/1000/Docker/moviepilot-v2/media +# MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads +# MEDIASTATION_DOWNLOAD_CONTAINER_DIR=/vol1/1000/qBittorrent/downloads +# +# 这只是 Docker bind mount，不会复制文件，不会占用双倍空间。 +# +# 本地测试模式： # MEDIASTATION_DATA_DIR=./data # MEDIASTATION_CACHE_DIR=./cache -# MEDIASTATION_MEDIA_DIR=/mnt/nas/media -# MEDIASTATION_DOWNLOAD_DIR=/mnt/nas/downloads +# MEDIASTATION_MEDIA_DIR=./media +# MEDIASTATION_DOWNLOAD_DIR=./downloads # # NAS / 飞牛路径必须使用绝对路径，例如： # MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media @@ -58,11 +70,10 @@ services: # 海报/背景图/转码缓存。可删除重建，但会重新下载图片和生成缓存。 - ${MEDIASTATION_CACHE_DIR:-./cache}:/cache - # 媒体库根目录。添加媒体库时使用容器内路径： - # 电影：/media/Movies - # 剧集：/media/TV - # 动漫：/media/Anime - # 综艺：/media/Variety + # 媒体库根目录。 + # 默认：宿主机目录映射到容器 /media，添加媒体库时填写 /media/电影、/media/电视剧。 + # NAS 直读：把 MEDIASTATION_MEDIA_CONTAINER_DIR 设置成与 MEDIASTATION_MEDIA_DIR 相同， + # 添加媒体库时即可直接填写 /vol1/.../media/电影、/vol1/.../media/电视剧。 # 如宿主机目录不同，请在 .env 中设置 MEDIASTATION_MEDIA_DIR。 # NAS / 飞牛等系统请写绝对路径，例如： # MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media @@ -71,11 +82,10 @@ services: # MEDIASTATION_MEDIA_CONTAINER_DIR 设置为同一个 /vol1/... 路径。 - ${MEDIASTATION_MEDIA_DIR:-./media}:${MEDIASTATION_MEDIA_CONTAINER_DIR:-/media}:ro - # 下载保存目录。订阅/站点下载的保存路径建议使用： - # /downloads/Movies - # /downloads/TV - # /downloads/Anime - # /downloads/Variety + # 下载保存目录。 + # 默认：宿主机目录映射到容器 /downloads，订阅保存根目录填写 /downloads。 + # NAS 直读：把 MEDIASTATION_DOWNLOAD_CONTAINER_DIR 设置成与 MEDIASTATION_DOWNLOAD_DIR 相同， + # 下载器保存根目录可直接填写 /vol1/1000/qBittorrent/downloads。 # 如果外部下载器也运行在 Docker 中，请给下载器挂载同一个宿主机目录。 # NAS / 飞牛等系统请写绝对路径，例如： # MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads