![Gemini_Generated_Image_l809rgl809rgl809.png](/static/img/4795ebfa86cb63d961c769f3f7d8020c.Gemini_Generated_Image_l809rgl809rgl809.webp)

PortNote 原项目好用，但中文和复制细节不太顺手。这篇转载整理了汉化版和 Docker 镜像，适合用来管理局域网设备端口和服务备注。



:::info{title="相关信息"}
[原地址](https://www.bilibili.com/opus/1129119156672659506?spm_id_from=333.1387.0.0)
:::

注意，需要把下面部署文件中的中文  访问端口  用户名  密码  修改成实际的内容：
```js
name: portnote

x-config: &config
  restart: always
  cpus: 1
  mem_limit: 512m
  logging:
    options:
      max-size: 1m
      max-file: "3"

services:
  portnote:
    container_name: portnote
    image: swr.cn-north-4.myhuaweicloud.com/firfe/port_note-zh:1.2.0
    <<: *config
    ports:
      - 访问端口:3000
    environment:
      JWT_SECRET: Firfe_JWT_SECRET
      USER_SECRET: Firfe_USER_SECRET
      LOGIN_USERNAME: 用户名
      LOGIN_PASSWORD: 密码
      DATABASE_URL: "postgresql://postgres:postgres@portnote-pg:5432/postgres"
    depends_on:
      portnote-pg:
        condition: service_started

  portnote-agent:
    container_name: portnote-agent
    image: haedlessdev/portnote-agent:1.2.0
    <<: *config
    environment:
      DATABASE_URL: "postgresql://postgres:postgres@portnote-pg:5432/postgres"
    depends_on:
      portnote-pg:
        condition: service_started

  portnote-pg:
    container_name: portnote-pg
    image: postgres:17.6-alpine3.22
    <<: *config
    environment:
      TZ: Asia/Shanghai
      TIME_ZONE: Asia/Shanghai
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: postgres
    volumes:
      # 数据位置
      - ./pg_data:/var/lib/postgresql/data

networks:
  default:
    name: portnote
    driver: bridge
```

转载-端口扫描工具portnote汉化

![B站订阅自动下载-docke部署bili-sync 头图](/static/img/12ed446db2b781a8ce47126c1037c08f.post-15-bili-sync.webp)

B 站收藏夹越攒越多，真正想看的内容反而容易失踪。bili-sync 可以按订阅自动下载视频，这篇记录 Docker 部署和把下载流程交给 NAS 的思路。



# docker-compose部署：

```js
services:
  bili-sync-rs:
    # 不推荐使用 latest 这种模糊的 tag，最好直接指明版本号,注意docker有更新
    image: amtoaer/bili-sync-rs:v2.6.3
    restart: unless-stopped
    network_mode: bridge
    # 该选项请仅在日志终端支持彩色输出时启用，否则日志中可能会出现乱码
    tty: true
    # 非必需设置项，推荐设置为宿主机用户的 uid 及 gid (`gid`)
    # 可以执行 `id ${user}` 获取 `user` 用户的 uid 及 gid
    # 程序下载的所有文件权限将与此处的用户保持一致，不设置默认为 Root
    user: 1000:1000
    hostname: bili-sync-rs
    container_name: bili-sync-rs
    # 程序默认绑定 0.0.0.0:12345 运行 http 服务
    # 可同时修改 compose 文件与 config.toml 变更服务运行的端口
    ports:
      - 12345:12345
    volumes:
      - ./config:/app/.config/bili-sync
      # metadata/people 正确挂载才能在 Emby 或 Jellyfin 中显示 UP 主头像
      # 右边的目标目录不固定，只需要确保目标目录与 bili-sync 中填写的“UP 主头像保存路径”保持一致即可
      - /vol2/1000/docker/emby/configs/metadata:/app/.config/bili-sync/upper_face
      # 接下来可以挂载一系列用于保存视频的目录，接着在 bili-sync 中配置将视频下载到这些目录即可
      # 例如：
      - /vol2/1000/Media/B站收藏:/home/amtoaer/HDDs/Videos/Bilibilis/
    # 如果你使用的是群晖系统，请移除最后的 logging 配置，否则会导致日志不显示
    logging:
      driver: "local"
```
# 相关配置：
参考：https://zhuanlan.zhihu.com/p/1938531839766687970

需要注意的是获取ac_time_value时：**先打开一个浏览器的无痕窗口** F12 打开开发者工具页面，选择控制台，**再登陆账户**，粘贴`window.localStorage.ac_time_value`回车即可获取。

# up主照片显示：
这里引用官方说明：对于使用 Emby、Jellyfin 媒体服务器的用户，需确保此处路径指向 Emby、Jellyfin 配置中的 /metadata/people/ 才能够正常在媒体服务器中显示 UP 主的头像，如下图：

<img src='/static/img/ab849972ee1abdb084665c15a72f048b.PixPin_2025-11-14_23-24-11.webp' width='500' height='auto' />


下载一个视频试试，看一下这个目录下是否有新添加的up主信息：

<img src='/static/img/0f0f41833380590cc6f96ac16af7eb06.PixPin_2025-11-14_23-25-08.webp' width='500' height='auto' />

最后，很关键的一点：**运行emby的计划任务，刷新数据库！**

<img src='/static/img/cf31d14d683d8e46bb94df27393f217b.PixPin_2025-11-14_23-27-38.webp' width='500' height='auto' />

# 关于报错：

检查刷新 Credential 遇到错误：request failed, status code: 86095, message: 86095，等待下一轮执行：

**开个不常用浏览器的无痕模式，然后再获取token，把这个浏览器关掉，确保docker占用一个单独的客户端id就可以了。**

B站订阅自动下载-docke部署bili-sync

![docker部署emby开心版 头图](/static/img/109b10a96205503a1cc9526026936e27.post-14-emby.webp)

Emby 部署本身不复杂，麻烦的是目录、端口和媒体库初始化要一次摆正。这里把 Docker Compose 和关键配置记下来，方便后面重建媒体服务。



```js
services:
   emby:
      container_name: emby-amilys
      image: amilys/embyserver:latest
      restart: unless-stopped
      network_mode: bridge
      ports:
         - 8896:8096
         - 8920:8920  # 可选：HTTPS端口
      volumes:
         - ./config:/config
         - ./config/hosts:/etc/hosts
         - /mnt/ARS2-NFS/nas/link:/media/video  # 媒体目录
         - /mnt/ARS2-NFS/nas/music:/media/music  # 音乐目录
         - /mnt/ARS2-NFS/nas/photos:/media/photos  # 照片目录
      environment:
         - UID=0
         - GID=0
         - GIDLIST=100,101
         - TZ=Asia/Shanghai
      devices:
         - /dev/dri:/dev/dri  # 硬件加速
      deploy:
         resources:
            limits:
               memory: 8G
            reservations:
               memory: 1G
```

docker部署emby开心版

![Movie-Pilot搭建及配置微信通知 头图](/static/img/eb0ef8e9ccb59f05702dfc15360048ee.post-13-movie-pilot.webp)

Movie-Pilot 的价值在于把影视自动化串起来，而微信通知是其中很关键的一环。这里记录从部署到消息推送的配置点，重点是别让通知链路断掉。



# 项目搭建
docker-comose部署：
```js
version: '3.3'
services:
  moviepilot:
    stdin_open: true
    tty: true
    container_name: moviepilot-v2
    hostname: moviepilot-v2
    network_mode: host
    volumes:
      - '/media:/media'#媒体文件存储目录
      - '/moviepilot-v2/config:/config'#配置文件、数据库、日志等
      - '/moviepilot-v2/core:/moviepilot/.cache/ms-playwright'#浏览器内核存储目录
      - '/var/run/docker.sock:/var/run/docker.sock:ro'# Docker 管理权限

    environment:
      - 'NGINX_PORT=3000'
      - 'PORT=3001'
      - 'PUID=0'
      - 'PGID=0'
      - 'UMASK=000'
      - 'TZ=Asia/Shanghai'
      - 'SUPERUSER=admin' #超级管理员用户名
      - 'SUPERUSER_PASSWORD=你的初始登录密码' #超级管理员初始密码

    restart: always
    image: jxxghp/moviepilot-v2:latest
```

# 部署微信通知

:::tip{title="提示"}
在云服务器（你的家庭宽带有公网ip才可以本地部署）部署微信代理服务器！否则本地搭建内网穿透是起不到转发通知的作用的。
:::
docker-compose：

```js
version: '3.3'
services:
  wxchat:
    container_name: wxchat
    restart: always
    ports:
      - '3100:80'
    image: 'ddsderek/wxchat:latest'
```

进入 mp 设定-通知-添加-WeChat通知，界面如下：
![PixPin_2025-11-05_21-52-01.png](/static/img/97285e7ddb6fb60eae6b7854c7a3aa9f.PixPin_2025-11-05_21-52-01.webp)

在企业微信端应用管理-接收消息-API接收配置相关参数：

URL为
`http(s)://DOMAIN:PORT/api/v1/message/?token=moviepilot`（其中moviepilot修改为实际配置中实际的API_TOKEN的值，DOMAIN、PORT替换为本工具的外网访问地址及端口，需要有公网IP域名并做好端口转发）

TOKEN和ENCODINGAESKEY与上图相同位置保持一致。

能正常保存即设置成功。

![PixPin_2025-11-05_21-58-49.png](/static/img/a9f7a1b8bc2250ef10840489b88232f8.PixPin_2025-11-05_21-58-49.webp)

最后别忘了在应用管理-企业可信ip添加自己的公网ip：

![PixPin_2025-11-05_21-57-17.png](/static/img/0811cdf71933ac17900231f2281d2dab.PixPin_2025-11-05_21-57-17.webp)

# 文件下载与整理


:::tip{title="常见问题"}
下载文件有目录没有文件：MP/QB/EMBY这个三个容器必须设置好相应的文件夹映射，缺一不可！

硬连接失败：注意必须在同一根目录下！
:::


<img src='/static/img/68a65a7480e43074a76a8e41b6ece3bd.PixPin_2025-11-06_11-30-37.webp' width='300' height='auto' />

Movie-Pilot搭建及配置微信通知

![为主域名添加子目录应用（2） 头图](/static/img/388229b28c2fa4b615b0f63a53784fc7.post-12-subdirectory-apps-2.webp)

一个主域名下面挂多个小工具，路径转发和资源路径最容易打架。这篇继续整理子目录应用的多工具方案，让 /tool-a、/tool-b 这种入口能规整地跑起来。



这个方案的核心是利用 Nginx Proxy Manager (NPM) 强大的路径转发和重写功能，将一个子目录（如 `/my-tool`）映射到一个“工具箱”主页，并能正确地分发到该主页下的各个子工具页面。

-----

# 1\. 核心思路：中心辐射型文件结构

我们不再将所有代码放在一个 `index.html` 文件中，而是创建一个“中心辐射型”的目录结构。

  * **中心 (Hub):** 一个 `index.html` 文件，作为工具箱的主页（卡片选择界面）。
  * **辐射 (Spokes):** 每一个工具都存放在自己的子文件夹中。

# 2\. 步骤一：创建文件结构

在服务器上（例如宝塔面板的 `/www/wwwroot/` 目录下），创建你的工具箱主文件夹，并按以下结构组织文件：

```
/www/wwwroot/my-toolbox/
    |
    ├── index.html           <-- (这是“中心”：工具箱的主页)
    |
    ├── tool-a/              <-- (辐射1：工具A)
    │   └── index.html       <-- (工具A的HTML/JS/CSS代码)
    |
    ├── tool-b/              <-- (辐射2：工具B)
    │   └── index.html       <-- (工具B的HTML/JS/CSS代码)
    |
    └── ...                  <-- (未来可添加更多工具文件夹)
```

# 3\. 步骤二：编写“中心”主页 (index.html)

这是 `my-toolbox/index.html` 文件的关键部分。你需要使用**相对路径**来链接到你的各个“辐射”工具。

```html
<body>
    <main>
        <div class="grid ...">

            <a href="./tool-a/" class="tool-card ...">
                <h2>工具A (FinalShell)</h2>
                <p>这是工具A的描述...</p>
            </a>

            <a href="./tool-b/" class="tool-card ...">
                <h2>工具B (MD-Replace)</h2>
                <p>这是工具B的描述...</p>
            </a>
            
        </div>
    </main>
</body>
```

  * **关键点**：链接 `href` 的值是 `./tool-a/` 和 `./tool-b/`。
  * `./` 代表“当前目录”。
  * 末尾的 `/` 很重要，它告诉浏览器去访问一个目录，而不是一个文件。

# 4\. 步骤三：启动 Docker 容器

使用一个 Nginx 容器来托管**整个** `my-toolbox` 文件夹。

```bash
docker run -d \
  --name my-toolbox-server \
  -p 5001:80 \
  -v /www/wwwroot/my-toolbox:/usr/share/nginx/html:ro \
  nginx:alpine
```

  * `-v`：将我们包含所有文件（主页 + 子工具）的 `my-toolbox` 文件夹，挂载到 Nginx 的根目录。
  * `-p`：将 Nginx 容器的 `80` 端口映射到服务器的 `5001` 端口。

# 5\. 步骤四：配置 NPM (关键)

这是让所有路径（主页和子工具）都能正确访问的“魔法”所在。

1.  登录 NPM，编辑你的主域名（例如 `zym588.me`）。

2.  进入 **"Custom locations"** 标签页。

3.  **删除**所有旧的 `/my-tool` 规则（如果存在）。

4.  点击 **"Add location"**，创建**唯一**的一条新规则：

      * **`Define location`**:
        `^~ /my-tool/`
        *(关键：`^~` 代表高优先级匹配，末尾的 `/` 至关重要)*

      * **`Forward Hostname / IP`**:
        `127.0.0.1`

      * **`Forward Port`**:
        `5001` *(指向步骤三中 Docker 容器的端口)*

      * **点击 齿轮(⚙️)图标**，进入 **"Custom Nginx Configuration"**：

      * **粘贴**以下这**唯一**的一行 `rewrite` 规则：

        ```nginx
        rewrite ^/my-tool/(.*)$ /$1 break;
        ```

5.  **保存**。

-----

### 为什么这样可行？（工作原理解析）

配置的这条规则，通过 `rewrite` 巧妙地处理了所有情况：

1.  **访问主页 ( .../my-tool )**：

      * Nginx 会自动在 URL 末尾补全斜杠，重定向到 `.../my-tool/`。

2.  **访问主页 ( .../my-tool/ )**：

      * `location` 匹配 `^~ /my-tool/`。
      * `rewrite` 规则被触发，`^/my-tool/(.*)$` 匹配成功，此时 `(.*)` 捕获的内容是**空字符串**。
      * URL 被重写为 `/$1`，即 `/`。
      * NPM 将这个 `/` 请求转发给 `127.0.0.1:5001`。
      * Docker 容器内的 Nginx 收到 `/` 请求，返回 `/usr/share/nginx/html/index.html`（**工具箱主页**）。**成功**。

3.  **点击卡片 ( .../my-tool/tool-a/ )**：

      * `location` 匹配 `^~ /my-tool/`。
      * `rewrite` 规则被触发，此时 `(.*)` 捕获的内容是 `tool-a/`。
      * URL 被重写为 `/$1`，即 `/tool-a/`。
      * NPM 将这个 `/tool-a/` 请求转发给 `127.0.0.1:5001`。
      * Docker 容器内的 Nginx 收到 `/tool-a/` 请求，返回 `/usr/share/nginx/html/tool-a/index.html`（**工具A页面**）。**成功**。

通过这个方案，你只需维护一个 Docker 容器和一个 NPM `location` 规则，就可以无限扩展你的工具箱。