by三生の博客

搜图教程

Sun, 07 Dec 2025 00:00:00 GMT

1、正文

在互联网上，有许多人可以仅仅通过一张图片，就帮人找到出处和来源，他们被大家称为 —— hero。想要成为一名 hero，就得学会如何以图搜图（以下简称“搜图”），提升自己的战斗力。

本文会介绍有关搜图的大体思路，以及列举一些我所收集到的相关工具。其实，搜图的本质，是借助不同的互联网工具，去串联起一条条互联网信息，并向上追溯其源头。所以搜图本身并不是多么高深的技术，其根本也不过是对于工具的运用罢了。就像远古社会使用石制工具，奴隶社会使用青铜工具一样，都是平平无奇的事情，只是工具的优劣有所不同。

搜图本身并没有什么好写的，不过是把图片丢进搜图工具里就行了，要强调的，无非是注意使用时的不同情况而已。图片分为完整与残缺两种状态。完整的图片不必多说，根据类别丢进相应的工具里，普通图片可以使用 Google 进行搜索，二次元图片使用 Saucenao 或 trace.moe 来搜索。而残缺的图片就麻烦一点了，要先尝试不同的工具去获取原图，这里推荐使用 Yandex 来搜索原图，然后再根据「搜索完整图片的方法」去走一遍搜索流程。最后，如果还是搜索不到，只能将我列举出来的相关工具挨个试一遍了。实在走投无路的话，也可以试试百度和必应，或许有奇效也说不定。

2、相关工具

2.1、Google

链接：https://www.google.com

Google 作为全球知名的互联网公司之一，其产品并不需要过多介绍，本身就是行业内的佼佼者。大多数公司的搜索引擎都有搜图功能，例如百度、必应一类的，但都不如 Google 搜图来得好用，虽然经过斯诺登事件后，其能力大大不如从前，但依旧可以在矮子里面拔高个。

<summary>点击查看如何开启 Google 搜图的完全体</summary>

打开 Google，进入 Settings > Search settings，点击 SafeSearch，然后选择 Off

</details>

<summary>点击查看示例图片</summary>

</details>

2.2、Yandex

链接：https://yandex.com

如果要说有什么工具，可以和 Google 搜图进行互补，那应该就只有 Yandex 了。作为一款来自俄罗斯的搜索引擎，它也是非常优秀的，哪怕不是用来搜图，也是一款很好用的搜索工具。

<summary>点击查看如何开启 Yandex 搜图的完全体</summary>

打开 Yandex，进入 Settings > Location，更改地址为中国大陆以外的地区，如 Tokyo，再点击 Save

然后进入 Settings > Search，修改 Filter search results 为 No filter，再点击 Save

</details>

<summary>点击查看示例图片</summary>

</details>

2.3、Saucenao

链接：https://saucenao.com

Saucenao 是针对二次元图片的搜索工具，可以搜索例如漫画、插画、动漫等相关图片，但是对于图片完整性有一定要求，如果有残缺的话可能无法精准识别。

<summary>点击查看示例图片</summary>

</details>

2.4、trace.moe

链接：https://trace.moe

trace.moe 的战斗力跟 Saucenao 大差不差，也是针对二次元的，不过多了一个独特的功能，就是可以定位动漫画面出现的时间点，甚至精确到秒，而且包括刚上映的剧场版和刚发售的 OVA。

<summary>点击查看示例图片</summary>

</details>

2.5、Ascii2d

链接：https://ascii2d.net

Ascii2d 适用于搜索各种场合的漫画、插画等，包括残缺的图片也可以使用，主要用来搜索 pixiv、twitter 的作品，可作为 Saucenao 和 trace.moe 的备选

<summary>点击查看示例图片</summary>

</details>

2.6、搜图 Bot

链接：https://soutubot.moe

这个工具适合搜索各种残缺的漫画，主要是针对 NHentai、EHentai 的作品，不过无法搜索到 pixiv、twitter 的作品，比较适合特定情况。

<summary>点击查看示例图片</summary>

</details>

2.7、IQDB

链接：https://iqdb.org

这是多个搜图工具的聚合，虽然应该说是「集百家之长于一身」，不过就我实际体验来说并不是很好。

<summary>点击查看示例图片</summary>

</details>

2.8、TinEye

链接：https://tineye.com

TinEye 是老牌的以图搜图工具，不过也并不算过时，适合用来查找图片的早期发布记录。

<summary>点击查看示例图片</summary>

</details>

Homepage 部署教程：个性化导航页

Sat, 29 Nov 2025 00:00:00 GMT

前言

Homepage 是一款高度个性化的用于自建导航页的工具，特别是对于 NAS 而言尤其好用，不仅可以避免被迫去记住各项服务的端口，就算只是充当网页书签也是很方便的。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Homepage

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/homepage/{icons,images}/ && cd <path>/homepage/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 54300:3000
    volumes:
      - ./:/app/config
      - ./icons:/app/public/icons
      - ./images:/app/public/images
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - PUID=0
      - PGID=0
      - HOMEPAGE_ALLOWED_HOSTS=*
    restart: unless-stopped

2.3、启动 Homepage

docker compose up -d

暴露端口

sudo ufw allow 54300

然后就可以打开 http://localhost:54300 访问 Homepage 的 Web 页面

2.4、关闭 Homepage

docker compose down

3、修改配置

3.1、配置介绍

第一次打开 Homepage 的 Web 页面，会自动生成如下的目录

<path>/homepage/
├── logs
│   └── homepage.log
├── bookmarks.yaml
├── custom.css
├── custom.js
├── services.yaml
├── settings.yaml
└── widgets.yaml

bookmarks.yaml 书签配置
custom.css 自定义 CSS
custom.js 自定义 JS
services.yaml 服务配置
settings.yaml 全局设置
widgets.yaml 部件配置

3.2、全局设置

settings.yaml 是用来控制页面的整体外观和行为的，可配置主题、背景和布局样式等。

具体可以前往 https://gethomepage.dev/configs/settings 查看文档

sudo nano settings.yaml

<summary>这是我本人的常用配置</summary>

[!TIP] 所有 <name> 请自行替换成个人实际的网站标题

在其中添加或修改以下内容：

title: <name> # 网站标题
language: zh-CN # 网站语言
hideVersion: true # 隐藏版本号
background:
  image: /images/background.png # 背景图片
  blur: xs  # 模糊程度（xs, sm, md, lg, xl, 2xl, 3xl, none）
  saturate: 100  # 饱和度
  brightness: 50  # 亮度
  opacity: 20  # 不透明度
headerStyle: clean # 头部样式
color: neutral # 颜色
theme: dark # 主题
useEqualHeights: true # 使用等高卡片

layout:
  NAS-SERVER:
    style: row
    columns: 3
  NAS-OTHER:
    style: row
    columns: 5
  BOOKMARKS:
    style: row
    columns: 5

</details>

* 3.2.1、layout

layout 是用来处理各项服务的布局的，如 style: row 是行布局，style: column 是列布局，而 columns 则可以控制行或列的服务数量。

例如以下配置：

layout:
  NAS-SERVER:
    style: row
    columns: 3
  NAS-OTHER:
    style: row
    columns: 5
  BOOKMARKS:
    style: row
    columns: 5

显示效果为：

3.3、服务配置

services.yaml 是用来定义要监控的各项服务的，每个服务可配置图标、链接、描述和小部件等。

具体格式可以前往 https://gethomepage.dev/configs/services 查看文档

配置服务组件可以前往 https://gethomepage.dev/widgets 查看文档

sudo nano services.yaml

在其中可以自行添加或修改各项服务

示例：

- NAS-SERVER:
    - Emby:
        icon: /icons/emby.png
        href: http://<location>:48096
        description: 媒体服务器
        widget:
            type: emby
            url: http://172.17.0.1:48096
            key: <key>
            enableBlocks: true
            enableNowPlaying: false
            expandOneStreamToTwoRows: false

- NAS-OTHER:
    - openlist:
        icon: /icons/openlist.png
        href: https://<safe_location>:45244
        description: 文件列表工具

    - pairdrop:
        icon: /icons/pairdrop.png
        href: http://<location>:43049
        description: 文件互传工具

- BOOKMARKS:
    - github:
        icon: /icons/github.png
        href: https://github.com

    - bilibili:
        icon: /icons/bilibili.ico
        href: https://www.bilibili.com

    - youtube:
        icon: /icons/youtube.png
        href: https://www.youtube.com

* 3.3.1、icons

icon 是用来配置图标的，不仅可以使用相对路径，也可以使用图片链接。

示例：

- Group A:
    - Service A:
        icon: /icons/xxx.png

    - Service B:
        icon: https://xxx.com/favicon.ico

而且 Homepage 还内置了 Dashboard Icons 项目，可以直接使用该项目提供的图标

示例：

- Group A:
    - Emby:
        icon: emby.png

3.4、部件配置

widgets.yaml 主要是用来修改一些页面部件的，比如系统状况、搜索框、天气和时间等。

具体可以前往 https://gethomepage.dev/configs/info-widgets 查看文档

sudo nano widgets.yaml

<summary>这是我本人的常用配置</summary>

在其中添加或修改以下内容：

- resources:
    cpu: true
    memory: true

- search:
    provider: google
    target: _blank

</details>

3.5、书签配置

说实话，我并不是很建议使用 Homepage 的书签，因为不好看，不如在服务配置里进行修改与添加，所以还是直接清空了的好。

sudo bash -c '> bookmarks.yaml'

3.6、自定义 JS

custom.js 主要是用来扩展功能的，满足不同用户的个性化需求。

sudo nano custom.js

<summary>这是我本人的常用配置</summary>

在其中添加或修改以下内容：

const currentDomain = window.location.hostname;
const safeDomain = /^(\d{1,3}\.){3}\d{1,3}$/.test(currentDomain) ? currentDomain : `safe.${currentDomain}`;

document.querySelectorAll('a[rel="noreferrer"]').forEach(link => {
    const href = link.href;
    
    if (href.includes('<location>')) {
        link.href = href.replace('<location>', currentDomain);
    } else if (href.includes('<safe_location>')) {
        link.href = href.replace('<safe_location>', safeDomain);
    }
});

这段 js 代码可以实现，自适应「公网域名」和「内网IP」访问 NAS 不同端口的服务。

假如，你有一台 NAS，它 DDNS 后的「公网域名」是 example.com，它的「内网IP」是 192.168.1.151。

当你使用 example.com:54300 访问 Homepage 时，服务配置里的 <location> 就会解析成 example.com

http://<location>:43049
=> http://example.com:43049

https://<safe_location>:45244
=> https://safe.example.com:45244

当你使用 192.168.1.151:54300 访问 Homepage 时，服务配置里的 <location> 就会解析成 192.168.1.151

http://<location>:43049
=> http://192.168.1.151:43049

https://<safe_location>:45244
=> https://192.168.1.151:45244

</details>

Emby 部署教程：拥有属于自己的媒体库

Sat, 15 Nov 2025 00:00:00 GMT

前言

对于 NAS 玩家而言，主流的自建媒体库项目大概有三个：Emby，Plex，Jellyfin。这三个项目都各有优缺点，也各有不同，不过总体来说都是很好的项目。

我个人的选择是 Emby，倒不是因为它有什么特别的，只不过它是我第一个接触到的而已，而且它也很能满足我目前的需求。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Emby

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/emby/config/ && cd <path>/emby/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <media_path> 请自行替换成个人实际媒体库路径
所有 <media_mount> 请自行替换成个人实际媒体库挂载点

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  emby:
    image: emby/embyserver:latest
    container_name: emby
    ports:
      - 48096:8096
    environment:
      - UID=0
      - GID=0
      - UMASK=000
    volumes:
      - ./config:/config
      - <media_path>:<media_mount>
    devices:
      - /dev/dri:/dev/dri
    restart: unless-stopped

也可自行添加代理，例如：

services:
  emby:
    image: emby/embyserver:latest
    container_name: emby
    ports:
      - 48096:8096
    environment:
      - UID=0
      - GID=0
      - UMASK=000
      - HTTP_PROXY=http://172.17.0.1:8118
      - HTTPS_PROXY=http://172.17.0.1:8118
      - NO_PROXY=localhost,127.0.0.1
    volumes:
      - ./config:/config
      - <media_path>:<media_mount>
    devices:
      - /dev/dri:/dev/dri
    restart: unless-stopped

2.3、启动 Emby

docker compose up -d

暴露端口

sudo ufw allow 48096

然后就可以打开 http://localhost:48096 访问 Emby 的 Web 页面

2.4、关闭 Emby

docker compose down

3、媒体库的添加

要进行媒体库的添加，请打开 Emby 的 Web 页面，进入 设置 > 媒体库

点击 新增媒体库

然后根据自己的喜好进行配置

<summary>这是我本人的常用配置</summary>

[!TIP] 个人建议关闭字幕的刮削

</details>

4、Premiere 的开启

关于 Emby 的 Premiere，我个人觉得没有必要去原价购买，太不划算了，所以我是在闲鱼上跟人拼了五人车，算下来大概一百来块。

[!TIP] 如果你也选择拼车，请先擦亮眼睛，防止被骗。

要进行 Premiere 的开启，请打开 Emby 的 Web 页面，进入 设置 > Emby Premiere

在 Emby Premiere 秘钥 填入你的 key

5、硬件解码的配置

[!TIP] 想要开启硬件解码，需要先获取 Premiere，并且确保当前设备可以正常使用核显或独显。

要进行硬件解码的配置，请打开 Emby 的 Web 页面，进入 设置 > 正在转码

在 启用硬件加速（如果可用） 中选择 高级

6、CSS 自定义

我个人对于 Emby 的 UI 接受度还行，反正也不丑，之所以要自定义 CSS，还是因为 Emby 那该死的推荐机制。

我的 Emby 中存在两个媒体库，一个是电影，一个是里番，它们存储的元数据都是单独影片的格式。Emby 有个推荐功能（没有关闭选项），当我打开电影分区时，下面的推荐竟然出现了里番的影片（不要问我经历了什么），天知道它为什么会跨媒体库进行影片推荐，既然 Emby 当前不支持修改推荐功能，只好从 CSS 方面下手给它全关了。

要进行 CSS 自定义，请打开 Emby 的 Web 页面，进入 设置 > 通用

在 自定义 CSS 中添加以下内容：

.suggestions {
    display: none !important;
}

SillyTavern 部署教程：自建 AI 角色扮演平台

Sat, 30 May 2026 00:00:00 GMT

前言

SillyTavern（简称 ST，也称傻酒馆）是一个可接入众多 LLM API 的角色扮演平台，它有着图像生成集成、TTS、世界书、自动翻译和可自定义的 UI 等一系列功能，并且可以借助丰富的第三方扩展，实现无限的功能延展与进化。它以 Node.js 20 作为底层，对于硬件的要求极低，同时有着庞大的社区支持，对于 AI 爱好者而言，是一款极为强大且优秀的工具。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 SillyTavern

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/silly_tavern/{config,data,plugins,extensions} && cd <path>/silly_tavern/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  sillytavern:
    container_name: sillytavern
    image: ghcr.io/sillytavern/sillytavern:latest
    environment:
      - NODE_ENV=production
      - FORCE_COLOR=1
      - SILLYTAVERN_HEARTBEATINTERVAL=30
      - TZ=Asia/Shanghai
    ports:
      - "41595:8000"
    volumes:
      - "./config:/home/node/app/config"
      - "./data:/home/node/app/data"
      - "./plugins:/home/node/app/plugins"
      - "./extensions:/home/node/app/public/scripts/extensions/third-party"
    healthcheck:
      test: ["CMD", "node", "src/healthcheck.js"]
      interval: 30s
      timeout: 10s
      start_period: 20s
      retries: 3
    restart: unless-stopped

2.3、修改 config 配置文件

[!TIP] 所有 <username> 请自行替换成个人实际用户名
所有 <password> 请自行替换成个人实际密码
所有 <proxy_url> 请自行替换成实际代理接口

docker compose up -d && sudo nano ./config/config.yaml

在其中添加或修改以下内容：

listen: true

whitelistMode: false
enableForwardedWhitelist: false
whitelistDockerHosts: false

basicAuthMode: true
basicAuthUser:
  username: "<username>"
  password: "<password>"

也可自行添加代理，例如：

requestProxy:
  enabled: true
  url: "<proxy_url>" # 例如 "socks5://172.17.0.1:1080"
  bypass:
    - localhost
    - 127.0.0.1

2.4、重启 SillyTavern

docker compose restart

暴露端口

sudo ufw allow 41595

然后就可以打开 http://localhost:41595 访问 SillyTavern 的 Web 页面

2.5、关闭 SillyTavern

docker compose down

3、初始配置

3.1、设置「语言」和「用户名」

第一次打开 SillyTavern 的 Web 页面时，可以立即设置 语言 与 用户名

3.2、接入模型API

打开 SillyTavern 的 Web 页面，进入 主页 > API 连接，自行填入相关信息

3.3、开启自动翻译

在使用 SillyTavern 时，可能会遇到 角色卡 或模型是以英文为主的，这时候就需要开启自动翻译，为自己营造更好的使用体验。

请注意，有些翻译服务的提供商可能需要网络代理才能成功连接，可以参照上文自行添加代理。

打开 SillyTavern 的 Web 页面，进入 主页 > 扩展程序 > 聊天翻译，自行填入相关信息

4、获取与导入「角色卡」

要获取角色卡，可以使用下面的 角色卡资源站点

然后打开 SillyTavern 的 Web 页面，进入 主页 > 角色管理，自行导入相关文件

4.1、角色卡 json 结构

如果寻找不到自己喜欢的角色卡，也可以将下面的 角色卡 json 结构 喂给 AI，让 AI 根据自己的需求去生成一张角色卡

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "角色名称",
    "description": "角色描述",
    "personality": "个性特征",
    "scenario": "场景设定",
    "first_mes": "首条消息",
    "mes_example": "对话示例",
    "creator_notes": "创作者注释",
    "system_prompt": "系统提示",
    "post_history_instructions": "历史处理指令",
    "alternate_greetings": ["替代问候语"],
    "tags": ["标签"]
  }
}

5、修改 UI 主题

在我看来，原生的 SillyTavern 主题并不够现代化，甚至可以说有些许丑陋。

这时候，一个优雅、美观的 UI 主题，就可以很好地提升使用体验。

在此，我推荐 MoonlitEchoesTheme 这个主题，它扁平，简约，又极为现代化，至少在我看来还不错。

::github{repo="RivelleDays/SillyTavern-MoonlitEchoesTheme"}

另外，还有一个官方扩展，名字叫 TopInfoBar，可以在聊天窗口顶部添加一个快捷栏，以支持快速切换聊天、搜索消息关键字等功能，在这里一并推荐。

::github{repo="SillyTavern/Extension-TopInfoBar"}

5.1、安装 UI 扩展

打开 SillyTavern 的 Web 页面，进入 主页 > 扩展程序，选择 安装扩展程序，然后填入以下 Git URL：

https://github.com/RivelleDays/SillyTavern-MoonlitEchoesTheme

https://github.com/SillyTavern/Extension-TopInfoBar

最后点击 给所有人安装

5.2、修改 config 的缩图设置

sudo nano ./config/config.yaml

在其中添加或修改以下内容：

thumbnails:
  enabled: true
  format: png
  quality: 100
  dimensions:
    bg:
      - 240
      - 135
    avatar:
      - 864
      - 1280

修改后重启 SillyTavern

rm -rf ./data/default-user/thumbnails && docker compose restart

5.3、导入主题文件

最后进入 主页 > 用户设置，导入下面的两个 主题文件

5.4、主题设定

做完以上的准备，还需要根据自己的喜好，去完成最后主题的设定，这里我放上个人的 主题设定 以供参考。

角色卡资源站点

VERT 部署教程：自建文件格式转换工具

Sat, 28 Feb 2026 00:00:00 GMT

前言

在日常生活中，我们常常需要进行文件格式的转换。大多数人会直接搜索并使用在线工具网站，但这些网站往往广告繁多，且对私密文件的安全性缺乏保障。

而 VERT 则是一个不错的解决方案。作为新一代开源文件转换器，它支持完全本地化部署在私人服务器上，让用户可以随时随地进行高效安全的文件格式转换。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 VERT

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/vert/ && cd <path>/vert/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  vert:
    image: ghcr.io/vert-sh/vert:latest
    container_name: vert
    ports:
      - 43279:80
    restart: unless-stopped

2.3、启动 VERT

docker compose up -d

暴露端口

sudo ufw allow 43279

然后就可以打开 http://localhost:43279 访问 VERT 的 Web 页面

2.4、关闭 VERT

docker compose down

3、修改样式

修改样式的目的是为了删除 VERT 的 about 页面，以及修改一些我认为没那么好的中文适配。

原版：

修改：

获取 CSS 文件名

docker exec -it vert find / -type f -name "0*.css"

提取 CSS 文件

[!TIP] 所有 <css_filename> 请自行替换成个人实际获取的 CSS 文件名，例如 0.CbWlcZGF.css

docker cp vert:/usr/share/nginx/html/_app/immutable/assets/<css_filename> ./0.css

修改 CSS 文件

sudo nano 0.css

在其中添加或修改以下内容：

...

footer, .justify-end:has(> .bg-accent-pink), a[href="/about/"] { display: none !important; }
.md\:max-w-\[6\.5rem\] { max-width: 15rem !important; }

注入 CSS 文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  vert:
    image: ghcr.io/vert-sh/vert:latest
    container_name: vert
    ports:
      - 43279:80
    volumes:
      - ./0.css:/usr/share/nginx/html/_app/immutable/assets/<css_filename>
    restart: unless-stopped

重启 VERT

docker compose down && docker compose up -d

PanSou 部署教程：自建网盘资源搜索工具

Thu, 19 Feb 2026 00:00:00 GMT

前言

PanSou 是一款高性能的「网盘资源」搜索工具，支持 TG频道 和 插件搜索。系统设计以性能和可扩展性为核心，并且支持多频道多插件并发搜索，以及结果的智能排序和网盘类型分类。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 PanSou

考虑到 PanSou 的 环境变量 过多，所以在此放出原项目地址，有需要的可以自行查看

::github{repo="fish2018/pansou"}

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/pansou/data/ && cd <path>/pansou/

2.2、编写 config.env 配置文件

sudo nano config.env

在其中添加或修改以下内容：

# 插件配置
ENABLED_PLUGINS=labi,zhizhen,shandian,duoduo,muou,wanou,hunhepan,jikepan,panwiki,pansearch,panta,qupansou,hdr4k,pan666,susu,thepiratebay,xuexizhinan,panyq,ouge,huban,cyg,erxiao,miaoso,fox4k,pianku,clmao,wuji,cldi,xiaozhang,libvio,leijing,xb6v,xys,ddys,hdmoli,clxiong,jutoushe,sdso,xiaoji,xdyh,haisou,bixin,djgou,nyaa,xinjuc,aikanzy,qupanshe,xdpan,discourse,yunsou,ahhhhfs,nsgame,quark4k,quarksoo,sousou,ash,feikuai,kkmao,alupan,ypfxw,mikuclub,daishudj,dyyj,meitizy,jsnoteclub,mizixing,lou1,yiove,zxzj,qingying,kkv

# Telegram频道配置
CHANNELS=tgsearchers4,Aliyun_4K_Movies,bdbdndn11,yunpanx,bsbdbfjfjff,yp123pan,sbsbsnsqq,yunpanxunlei,tianyifc,BaiduCloudDisk,txtyzy,peccxinpd,gotopan,PanjClub,kkxlzy,baicaoZY,MCPH01,MCPH02,MCPH03,bdwpzhpd,ysxb48,jdjdn1111,yggpan,MCPH086,zaihuayun,Q66Share,ucwpzy,shareAliyun,alyp_1,dianyingshare,Quark_Movies,XiangxiuNBB,ydypzyfx,ucquark,xx123pan,yingshifenxiang123,zyfb123,tyypzhpd,tianyirigeng,cloudtianyi,hdhhd21,Lsp115,oneonefivewpfx,qixingzhenren,taoxgzy,Channel_Shares_115,tyysypzypd,vip115hot,wp123zy,yunpan139,yunpan189,yunpanuc,yydf_hzl,leoziyuan,Q_dongman,yoyokuakeduanju,TG654TG,WFYSFX02,QukanMovie,yeqingjie_GJG666,movielover8888_film3,Baidu_netdisk,D_wusun,FLMdongtianfudi,KaiPanshare,QQZYDAPP,rjyxfx,PikPak_Share_Channel,btzhi,newproductsourcing,cctv1211,duan_ju,QuarkFree,yunpanNB,kkdj001,xxzlzn,pxyunpanxunlei,jxwpzy,kuakedongman,liangxingzhinan,xiangnikanj,solidsexydoll,guoman4K,zdqxm,kduanju,cilidianying,CBduanju,SharePanFilms,dzsgx,BooksRealm,Oscar_4Kmovies,douerpan,baidu_yppan,Q_jilupian,Netdisk_Movies,yunpanquark,ammmziyuan,ciliziyuanku,cili8888,jzmm_123pan,Q_dianying,domgmingapk,dianying4k,q_dianshiju,tgbokee,ucshare,godupan,gokuapan

2.3、编写 docker-compose 配置文件

[!TIP] 所有 <username> 请自行替换成个人实际用户名
所有 <password> 请自行替换成个人实际密码

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  pansou:
    image: ghcr.io/fish2018/pansou-web:latest
    container_name: pansou
    ports:
      - "34654:80"
    env_file:
      - config.env
    environment:
      # 基础配置
      - DOMAIN=localhost
      - PANSOU_PORT=8888
      - PANSOU_HOST=127.0.0.1

      # 数据目录配置
      - CACHE_PATH=/app/data/cache
      - LOG_PATH=/app/data/logs

      # 高级配置
      - CACHE_MAX_SIZE=100
      - CACHE_ENABLED=true
      - CACHE_TTL=60
      - MAX_CONCURRENCY=200
      - MAX_PAGES=30
      - ASYNC_PLUGIN_ENABLED=true
      - ASYNC_RESPONSE_TIMEOUT=60
      - ASYNC_MAX_BACKGROUND_WORKERS=20
      - ASYNC_MAX_BACKGROUND_TASKS=100
      - ASYNC_CACHE_TTL_HOURS=1

      # 认证配置
      - AUTH_ENABLED=true
      - AUTH_USERS=<username>:<password>
      - AUTH_TOKEN_EXPIRY=24
    volumes:
      - ./data:/app/data
    restart: unless-stopped

也可自行添加代理，例如：

services:
  pansou:
    image: ghcr.io/fish2018/pansou-web:latest
    container_name: pansou
    ports:
      - "34654:80"
    env_file:
      - config.env
    environment:
      # 基础配置
      - DOMAIN=localhost
      - PANSOU_PORT=8888
      - PANSOU_HOST=127.0.0.1

      # 数据目录配置
      - CACHE_PATH=/app/data/cache
      - LOG_PATH=/app/data/logs

      # 高级配置
      - CACHE_MAX_SIZE=100
      - CACHE_ENABLED=true
      - CACHE_TTL=60
      - MAX_CONCURRENCY=200
      - MAX_PAGES=30
      - ASYNC_PLUGIN_ENABLED=true
      - ASYNC_RESPONSE_TIMEOUT=60
      - ASYNC_MAX_BACKGROUND_WORKERS=20
      - ASYNC_MAX_BACKGROUND_TASKS=100
      - ASYNC_CACHE_TTL_HOURS=1

      # 代理配置
      - PROXY=http://172.17.0.1:8118
      
      # 认证配置
      - AUTH_ENABLED=true
      - AUTH_USERS=<username>:<password>
      - AUTH_TOKEN_EXPIRY=24
    volumes:
      - ./data:/app/data
    restart: unless-stopped

2.4、启动 PanSou

docker compose up -d

暴露端口

sudo ufw allow 34654

然后就可以打开 http://localhost:34654 访问 PanSou 的 Web 页面

2.5、关闭 PanSou

docker compose down

3、修改样式

修改样式的目的是为了删除 PanSou 的页脚，当然，这纯属我个人的喜好。

获取 CSS 文件名

docker exec -it pansou find / -type f -name "index*.css"

提取 CSS 文件

[!TIP] 所有 <index_filename> 请自行替换成个人实际获取的 CSS 文件名，例如 index-CTkyXEFf.css

docker cp pansou:/app/frontend/dist/assets/<index_filename> ./index.css

修改 CSS 文件

sudo nano index.css

在其中添加或修改以下内容：

...

footer { display: none !important; }

注入 CSS 文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  pansou:
    image: ghcr.io/fish2018/pansou-web:latest
    container_name: pansou
    ports:
      - "34654:80"
    env_file:
      - config.env
    environment:
      # 基础配置
      - DOMAIN=localhost
      - PANSOU_PORT=8888
      - PANSOU_HOST=127.0.0.1

      # 数据目录配置
      - CACHE_PATH=/app/data/cache
      - LOG_PATH=/app/data/logs

      # 高级配置
      - CACHE_MAX_SIZE=100
      - CACHE_ENABLED=true
      - CACHE_TTL=60
      - MAX_CONCURRENCY=200
      - MAX_PAGES=30
      - ASYNC_PLUGIN_ENABLED=true
      - ASYNC_RESPONSE_TIMEOUT=60
      - ASYNC_MAX_BACKGROUND_WORKERS=20
      - ASYNC_MAX_BACKGROUND_TASKS=100
      - ASYNC_CACHE_TTL_HOURS=1

      # 认证配置
      - AUTH_ENABLED=true
      - AUTH_USERS=<username>:<password>
      - AUTH_TOKEN_EXPIRY=24
    volumes:
      - ./data:/app/data
      - ./index.css:/app/frontend/dist/assets/<index_filename>
    restart: unless-stopped

重启 PanSou

docker compose down && docker compose up -d

Jellyfin 部署教程：拥有属于自己的媒体库 E2

Fri, 06 Feb 2026 00:00:00 GMT

前言

我之前曾写过有关 Emby 的部署教程，而 Emby 也确实是一个非常优秀的媒体库项目，但毕竟「金无足赤，人无完人」，在我看来 Emby 也并不能完全满足我的要求。所以，我选择使用 Jellyfin 这个项目来作为我的第二个选择，用以补全我对于媒体库的需求。

而且在 Emby，Plex，Jellyfin 这三个项目中，只有 Jellyfin 是完全免费且开源的，作为曾经 Emby 的一个分支，它的背后站着无数个开源创作者。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Jellyfin

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/jellyfin/{config,cache}/ && cd <path>/jellyfin/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <media_path> 请自行替换成个人实际媒体库路径
所有 <media_mount> 请自行替换成个人实际媒体库挂载点

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  jellyfin:
    image: nyanmisaka/jellyfin:latest
    container_name: jellyfin
    ports:
      - 33612:8096
    environment:
      - UID=0
      - GID=0
      - UMASK=000
    volumes:
      - ./config:/config
      - ./cache:/cache
      - <media_path>:<media_mount>
    devices:
      - /dev/dri:/dev/dri
    restart: unless-stopped

也可自行添加代理，例如：

services:
  jellyfin:
    image: nyanmisaka/jellyfin:latest
    container_name: jellyfin
    ports:
      - 33612:8096
    environment:
      - UID=0
      - GID=0
      - UMASK=000
      - HTTP_PROXY=http://172.17.0.1:8118
      - HTTPS_PROXY=http://172.17.0.1:8118
      - NO_PROXY=localhost,127.0.0.1
    volumes:
      - ./config:/config
      - ./cache:/cache
      - <media_path>:<media_mount>
    devices:
      - /dev/dri:/dev/dri
    restart: unless-stopped

2.3、启动 Jellyfin

docker compose up -d

暴露端口

sudo ufw allow 33612

然后就可以打开 http://localhost:33612 访问 Jellyfin 的 Web 页面

2.4、关闭 Jellyfin

docker compose down

3、媒体库的添加

要进行媒体库的添加，请打开 Jellyfin 的 Web 页面，进入 设置 > 媒体库 > 媒体库

点击 添加媒体库

然后根据自己的喜好进行配置

<summary>这是我本人的常用配置</summary>

</details>

4、硬件解码的配置

[!TIP] 请确保当前设备可以正常使用核显或独显。

要进行硬件解码的配置，请打开 Jellyfin 的 Web 页面，进入 设置 > 播放 > 转码

在 硬件加速 中选择 Intel QuickSync (QSV)，然后勾选其它需要的选项

5、CSS 自定义

与 Emby 相比，Jellyfin 在我眼里算是丑陋了很多的，所以我便上手写了 CSS 进行修改，当然也是以 Emby 作为参考的。

要进行 CSS 自定义，请打开 Jellyfin 的 Web 页面，进入 设置 > 常规

在 自定义 CSS 代码 中添加以下内容：

.emby-input, .emby-textarea, .emby-select, .emby-button, .checkboxList, .cardBox, .cardContent, .paperList {
    border-radius: .5em !important;
}

.emby-select {
    padding-inline-start: .8rem !important;
}

.content-primary {
    padding-inline-start: 2.7rem !important;
}

.checkboxList, .skinHeader {
    background-color: #2B2B2B !important;
}

.backgroundContainer, .noBackdropTransparency .detailPageSecondaryContainer {
    background-color: #1E1E1E !important;
}

.mainDrawer, .drawer-open, .MuiDrawer-paper {
    background-color: #282828 !important;
}

.sectionTitle, .cardText-first {
    color: #ffffff !important;
}


.backgroundContainer.withBackdrop {
    background-color: rgba(0, 0, 0, 0.86) !important;
}

.detailPageSecondaryContainer.padded-bottom-page, .detailPagePrimaryContainer, .skinHeader.osdHeader {
    background-color: transparent !important;
}

.skinHeader.semiTransparent {
    backdrop-filter: blur(10px) !important;
    background-color: rgba(43, 43, 43, 0.4) !important;
}


.recommendations, .selectContainer:has(label[for="selectTheme"]) {
    display: none !important;
}

Music-Tag-Web 部署教程

Sun, 01 Feb 2026 00:00:00 GMT

前言

Music-Tag-Web 是一款可以自动编辑歌曲的标题、专辑、艺术家、歌词、封面等信息的音乐标签编辑器工具，支持 FLAC、APE、WAV、AIFF、WV、TTA、MP3、M4A、OGG、MPC、OPUS、WMA、DSF、MP4 等音频格式。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Music-Tag-Web

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/music_tag_web/data/ && cd <path>/music_tag_web/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <music_path> 请自行替换成个人实际音乐库路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - 48001:8001
    volumes:
      - ./data:/app/data
      - <music_path>:/app/media:rw
    command: /start
    restart: unless-stopped

2.3、启动 Music-Tag-Web

docker compose up -d

暴露端口

sudo ufw allow 48001

然后就可以打开 http://localhost:48001 访问 Music-Tag-Web 的 Web 页面

2.4、关闭 Music-Tag-Web

docker compose down

3、后台配置

打开 http://localhost:48001/admin 可以访问 Music-Tag-Web 的管理后台

[!NOTE] 默认用户名：admin
默认密码：admin

3.1、修改后台管理员

打开 Music-Tag-Web 的管理后台，进入 用户管理 > Subsonic 用户

点击「用户ID」为 1 的用户，进行相应的配置

3.2、修改初始用户

打开 Music-Tag-Web 的管理后台，进入 用户管理 > 用户

点击「用户ID」为 1 的用户，进行相应的配置

<!-- ---

4、破解 V2

Music Tag Web V2 具有 V1 的所有功能，并且进行了全方位的进化，是集合音乐标签刮削和音乐播放一体的个人音乐库解决方案。

虽然我研究出了破解方法，但还是希望大家能多多支持开发者，赞助开发者的爱发电

提取 middleware.py 文件

docker cp music-tag-web:/app/component/drf/middleware.py ./middleware.py

修改 middleware.py 文件

sudo nano middleware.py

在其中添加或修改以下内容：

def get_user():
    from applications.task.models import SysSettings

    code_obj = SysSettings.objects.filter(key="code").first()
    version = "V1"
    if not code_obj:
        return version
    lisense_code = code_obj.value
    try:
        is_validate = validate_lisense_code(lisense_code)
    except Exception:
        is_validate = False
    if is_validate:
        version = "V2"
    return version
    return "V2"

注入 middleware.py 文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - 48001:8001
      - 48001:8002
    volumes:
      - ./data:/app/data
      - <music_path>:/app/media:rw
      - ./middleware.py:/app/component/drf/middleware.py
    command: /start
    restart: unless-stopped

重启 Music-Tag-Web

docker compose down && docker compose up -d
``` -->

关于移动光猫的操作记录

Sat, 03 Jan 2026 00:00:00 GMT

前言

由于最近 PT 上传太多，导致我的网络环境被运营商调成了 NAT4，同时 IPv6 也被回收了。虽然问题目前还没解决（申诉后 2026.1.19 已解决），但由于一直在折腾光猫，于是便决定记录一些有关移动光猫的相关操作。

1、重置光猫

[!TIP] 重置光猫前，请先使用光猫背后标签的 user 账号登录光猫，并且进入 网络 > 远程管理 > PASSWORD 认证，记录下 password 值，这将用于光猫重置后的设备注册。

每一台光猫都有一个 reset 孔，可用牙签或类似物品捅进去并等待。重置时要注意光猫的指示灯，有的光猫的指示灯全亮一次，就代表开始重置，当然，也有的是全亮两次或者三次。我个人建议，等待 30 秒后再松开。

重置完光猫后，就可以打开光猫的登录页面，点击 设备注册，填入一开始记录的 password 值，开始下发数据进行注册，注册完成之后光猫才可以正常上网。

在「重置光猫」和 设备注册 后的「数据下发」中间，可以进行光猫的配置，但事实上，有一部分配置在数据下发后，会被运营商的配置覆盖掉，并且数据下发之后，默认超密也会被替换掉。

于是，我就琢磨出了一个办法，不通过 设备注册 来完成数据下发，而是删除宽带设置中的 TR069 之后，自己填写 INTERNET 连接的配置，或者直接编写桥接的配置，然后进入 网络 > 远程管理 中，在 LOID 认证 和 PASSWORD 认证 中，填入一开始记录的 password 值。通过这个办法，既可以保障能通过光猫来连接互联网，也能保障默认超密不会被替换掉。有关 INTERNET 和桥接的配置，在后文中会提到。

但是这个办法的局限性很大，需要你略微了解光猫的宽带设置，同时又知道自己宽带的账号，密码和 VLAN ID 之类的信息，所以并不是很推荐使用这个办法。

这里也顺带补充一下移动光猫的默认超密，其它运营商的默认超密请自行搜索。

账号：CMCCAdmin
密码：aDm8H%MdA

2、Telnet

Telnet 是一个简单的协议，可以通过命令行来远程操控服务器。不过它是明文传输的，相比 SSH 的加密来说，它的安全性极低，但对于光猫这种局域网的设备来说，却又是极为方便的。并且通过 Telnet 可以实现很多高级操作，如修改光猫的超密，防火墙，以及注册地址。

1、首先需要做的是，想办法开启光猫的 Telnet。
2、然后 Windows 打开命令行，执行 telnet 192.168.1.1，使用 Username: CMCCAdmin; Password: aDm8H%MdA 进行登录。
3、最后执行 su，使用 Password: aDm8H%MdA 来获取光猫的 root 权限。

<summary>目前我搜集到了几种开启光猫 Telnet 的办法，需要挨个尝试</summary>

[1] 直接在光猫中找到配置并启用，不过概率很小。
[2] 登录 user 账号后，再打开 http://192.168.1.1/getpage.gch?pid=1002&nextpage=tele_sec_tserver_t.gch 或 http://192.168.1.1/usr=CMCCAdmin&psw=aDm8H%25MdA&cmd=1&telnet.gch。
[3] 使用 zteOnu 这个项目，将电脑的 MAC 地址修改成 00-07-29-55-35-57，然后通过 .\zteOnu.exe --ip "192.168.1.1" --new --user "CMCCAdmin" --pass "aDm8H%MdA" --port 80 --tp 23 --telnet 这个命令来开启光猫的 Telnet，如果是非移动的光猫，需要将 user 和 aDm8H%MdA 的内容，换成对应运营商的超密。

这里补充一下 Windows 如何通过 PowerShell 来修改 MAC 地址，记得使用 <kbd>Win</kbd> + <kbd>X</kbd> 选择 Windows PowerShell（管理员） 来运行终端，同时也得记得保存对应网络适配器的原始 MAC 地址

# 查看当前网络适配器
Get-NetAdapter

# 修改对应网络适配器的 MAC 地址
Set-NetAdapter -Name "<name>" -MacAddress "<mac>"

[!NOTE] 如果以上方法都失败了，只能说明天意如此，还是趁早放弃吧

</details>

<summary>大部分 Windows 需要手动开启 Telnet 开关</summary>

打开 控制面板，进入 控制面板 > 程序，点击 启用或关闭 Windows 功能，在其中找到 Telnet Client 并勾选，最后点击确定。

</details>

操作完上面的内容，就可以通过 sidbg 1 DB p DevAuthInfo 来查看用户表，如果其中包括 user、CMCCAdmin，则代表目前为止的操作是成功的，最后再执行下面这几行命令，就可以重新设置光猫的超密。

sidbg 1 DB set DevAuthInfo 0 User CMCCAdmin
sidbg 1 DB set DevAuthInfo 0 Pass aDm8H%MdA
sidbg 1 DB save

然后就可以打开光猫的登录页面，使用默认超密来登录光猫了。

<summary>此外再补充一些其它的 Telnet 命令</summary>

# 查看当前超密
sidbg 1 DB p DevAuthInfo

# 查看配置文件
vi /etc/config/network

# 查找宽带密码
cd / && find -type f -name '*'|xargs grep '你的宽带账号'

# 禁用 TR069 连接
sidbg 1 DB set WANC 0 Enable 0

# 修改 ACS 报告 URL
sidbg 1 DB set MgtServer 0 URL http://0.0.0.0

# 禁用定时报表
sidbg 1 DB set MgtServer 0 PeriodicInformEnable 0

</details>

3、宽带设置

将光猫改成桥接模式，应该是大部分人折腾软路由最主要的目标。因为开启桥接之后，~~大概率可以获取 公网 IP 以及更好的 NAT 体验~~。

要想开启桥接模式，就得打开光猫的 Web UI，进入 网络 > 宽带设置 > Internet 连接，不同版本的光猫可能略有出入，需要自行调整。

然后点击 连接名称，就能在下拉栏里看到光猫自带的连接配置，大概分为以下几类：

1、TR069：运营商用来对光猫进行远程管理和控制的
2、OTHER：一般是用来观看运营商的 iptv 服务
3、VOIP：这个连接是用来打网络电话的，普通用户不用管
4、INTERNET：这是最重要的，用于光猫和互联网的连接

对于我个人而言，实在是无法接受，光猫的管理权被运营商时刻掌控着，所以我会直接删除 TR069。当然，如果觉得无所谓的话，也可以保留着。

要改桥接的话，就得涉及到 INTERNET 的配置，但大部分光猫是不支持修改已经应用的配置的，那就得删除重建。删除前，请截图保存光猫自带的配置进行备份，方便后续的复原。

要提一句的是，有关宽带账号和密码的获取，这两个都可以在 INTERNET 的配置中查看。账号一般就是对应的手机号码，而密码基本都是不显示的。对于大部分光猫来说，可以通过 <kbd>F12</kbd> 审查元素，将密码栏的 type="password" 改成 type="text" 来强制显示，如果还是获取不到的话，可以通过上文补充的 Telnet 命令进行获取，或者直接询问装宽带的师傅。

准备好后，就可以 新建连接 用于桥接：

IP 协议版本：IPv4/v6
模式：Bridge
端口绑定：一般是选择 LAN1，大部分光猫只有这个网口的传输速率是最大的
VLAN 模式：改写
VLAN ID：需要查看原 INTERNET 的连接名称，如 INTERNET_R_VID_400 对应的就是 400
802.1p：与原 INTERNET 的一样就行

VueTorrent 使用教程：现代化 qBittorrent 主题

Sat, 27 Dec 2025 00:00:00 GMT

前言

众所周知，qBittorrent 是一款非常好用的 p2p 下载工具，不过它的功能虽然强大，但界面却称不上美观。而 VueTorrent 就是一个专门为 qBittorrent 设计的现代化主题，不仅有华丽的外表，也有细节上的小巧思。比如原生的 qBittorrent 并没有分页功能，当保存的种子过多时，加载就会产生卡顿，但这些小问题在 VueTorrent 上都得到了很好的处理。

值得一提的是，VueTorrent 也为移动端进行了适配，可以通过 PWA 安装在手机上使用。说真的，原生的 qBittorrent 在移动端的体验感真的很差，让人没有丝毫使用的欲望。

有关 qBittorrent 的相关内容可以查看 qBittorrent 部署教程

1、进入文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

cd <path>/qbittorrent/config/

2、下载 VueTorrent

前往 https://github.com/VueTorrent/VueTorrent 选择合适的版本

::github{repo="VueTorrent/VueTorrent"}

然后下载相应的文件

wget -O vuetorrent.zip <url>

例如：

wget -O vuetorrent.zip https://github.com/VueTorrent/VueTorrent/releases/download/v2.31.2/vuetorrent.zip

也可自行添加代理，例如：

http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118 \
  wget -O vuetorrent.zip https://github.com/VueTorrent/VueTorrent/releases/download/v2.31.2/vuetorrent.zip

解压文件

unzip vuetorrent.zip -d vuetorrent && rm -rf vuetorrent.zip

3、应用 VueTorrent

打开 qBittorrent 的 Web 页面，进入 设置 > WebUI，开启 使用备选 WebUI，在 文件路径 中填入 /config/vuetorrent

应用 VueTorrent 后，页面会自动切换成英文，需要手动在 设置 里面进行切换中文

MoviePilot 部署教程：PT 媒体聚合工具

Wed, 03 Dec 2025 00:00:00 GMT

前言

在 PT 这个圈子里，除了一些刷流工具以外，最为出名的，当是 NASTool 和 MoviePilot 这类实际应用工具了。可 NASTool 也已经略显落后，比不上 MoviePilot 这个后继者，更不用说 MoviePilot 本身已从 v1 跨越到了 v2。MoviePilot 可以聚合多个 PT 站点的影视资源，实现搜索与下载，同时也能实现自动订阅与整理，是 PT 玩家的观影必备工具。

[!TIP] 注：本文默认读者拥有一定的 PT 常识，并且已部署了下载器

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 MoviePilot

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/moviepilot/{config,core,redis,postgresql}/ && cd <path>/moviepilot/

2.2、编写 docker-compose 配置文件

具体配置可以前往 https://wiki.movie-pilot.org/zh/install 查看文档
关于环境变量可以前往 https://wiki.movie-pilot.org/zh/configuration 查看文档

[!TIP] 所有 <.*_path> 请自行替换成个人实际选择的路径
所有 <.*_mount> 请自行替换成个人实际选择的挂载点
所有 <admin_password> 请自行替换成个人实际选择的管理员密码

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  moviepilot:
    image: jxxghp/moviepilot-v2:latest
    container_name: moviepilot_v2
    hostname: moviepilot_v2
    ports:
      - 43000:3000
      - 43001:3001
    volumes:
      - ./config:/config
      - ./core:/moviepilot/.cache/ms-playwright
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - <moviepilot_path>:<moviepilot_mount>
      - <qbittorrent_path>:<qbittorrent_mount>
      - <transmission_path>:<transmission_mount>
    environment:
      - NGINX_PORT=3000
      - PORT=3001
      - PUID=0
      - PGID=0
      - UMASK=000
      - TZ=Asia/Shanghai
      - SUPERUSER=<admin_name>
      - SUPERUSER_PASSWORD=<admin_password>
      - MOVIEPILOT_AUTO_UPDATE=false
      - DB_TYPE=postgresql
      - DB_POSTGRESQL_HOST=postgresql
      - DB_POSTGRESQL_PORT=5432
      - DB_POSTGRESQL_DATABASE=moviepilot
      - DB_POSTGRESQL_USERNAME=moviepilot
      - DB_POSTGRESQL_PASSWORD=password4postgres
      - CACHE_BACKEND_TYPE=redis
      - CACHE_BACKEND_URL=redis://:password4redis@redis:6379
    depends_on:
      postgresql:
        condition: service_healthy
      redis:
        condition: service_healthy
    stdin_open: true
    tty: true
    restart: always
    
  redis:
    image: redis
    volumes:
      - ./redis:/data
    command: redis-server --save 600 1 --requirepass password4redis
    healthcheck:
      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: always

  postgresql:
    image: postgres:17-alpine
    volumes:
      - ./postgresql:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=moviepilot
      - POSTGRES_USER=moviepilot
      - POSTGRES_PASSWORD=password4postgres
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U moviepilot -d moviepilot"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: always

也可自行添加代理，例如：

services:
  moviepilot:
    image: jxxghp/moviepilot-v2:latest
    container_name: moviepilot_v2
    hostname: moviepilot_v2
    ports:
      - 43000:3000
      - 43001:3001
    volumes:
      - ./config:/config
      - ./core:/moviepilot/.cache/ms-playwright
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - <moviepilot_path>:<moviepilot_mount>
      - <qbittorrent_path>:<qbittorrent_mount>
      - <transmission_path>:<transmission_mount>
    environment:
      - NGINX_PORT=3000
      - PORT=3001
      - PUID=0
      - PGID=0
      - UMASK=000
      - TZ=Asia/Shanghai
      - SUPERUSER=<admin_name>
      - SUPERUSER_PASSWORD=<admin_password>
      - MOVIEPILOT_AUTO_UPDATE=false
      - PROXY_HOST=socks5h://172.17.0.1:1080
      - DB_TYPE=postgresql
      - DB_POSTGRESQL_HOST=postgresql
      - DB_POSTGRESQL_PORT=5432
      - DB_POSTGRESQL_DATABASE=moviepilot
      - DB_POSTGRESQL_USERNAME=moviepilot
      - DB_POSTGRESQL_PASSWORD=password4postgres
      - CACHE_BACKEND_TYPE=redis
      - CACHE_BACKEND_URL=redis://:password4redis@redis:6379
    depends_on:
      postgresql:
        condition: service_healthy
      redis:
        condition: service_healthy
    stdin_open: true
    tty: true
    restart: always
    
  redis:
    image: redis
    volumes:
      - ./redis:/data
    command: redis-server --save 600 1 --requirepass password4redis
    healthcheck:
      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: always

  postgresql:
    image: postgres:17-alpine
    volumes:
      - ./postgresql:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=moviepilot
      - POSTGRES_USER=moviepilot
      - POSTGRES_PASSWORD=password4postgres
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U moviepilot -d moviepilot"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: always

2.3、启动 MoviePilot

docker compose up -d

暴露端口

sudo ufw allow 43000

然后就可以打开 http://localhost:43000 访问 MoviePilot 的 Web 页面

2.4、关闭 MoviePilot

docker compose down

3、设定

3.1、系统

打开 MoviePilot 的 Web 页面，进入 设定 > 系统

* 3.1.1、基础设置

基础设置里最重要的是 Github Token 的设置，需要前往 https://github.com/settings/tokens 自行获取

* 3.1.2、下载器

点击 +，自行选择对应的下载器

然后点击相应的下载器，修改相关信息，最后点击 确认

* 3.1.3、媒体服务器

点击 +，自行选择对应的媒体服务器

然后点击相应的媒体服务器，修改相关信息，最后点击 确认

3.2、存储&目录

打开 MoviePilot 的 Web 页面，进入 设定 > 存储&目录

* 3.2.1、存储

点击 +，自行选择对应的存储，默认使用的是本地存储

* 3.2.2、目录

点击 + 添加目录，然后进行相应的修改

目录的设置看个人需求，我这里是设置了电影和电视剧两个目录，因为动漫的下载与整理用的是我自己的程序

4、站点管理

4.1、添加站点

打开 MoviePilot 的 Web 页面，进入 站点管理，点击右下角的按钮添加站点

填入站点的相关信息

4.2、应用站点

打开 MoviePilot 的 Web 页面，进入 设定 > 搜索&下载，启用相关站点

打开 MoviePilot 的 Web 页面，进入 设定 > 订阅，启用相关站点

5、插件

5.1、获取插件

打开 MoviePilot 的 Web 页面，进入 插件 > 插件市场，点击右下角的按钮，搜索相关插件，这里推荐 媒体库封面生成 和 聚合消息通知

5.2、修改插件

打开 MoviePilot 的 Web 页面，进入 插件 > 修改插件，点击相应的插件，修改相关信息

媒体库封面生成：

聚合消息通知：

OpenWebUI 部署教程：自建私有化 AI 平台

Wed, 03 Dec 2025 00:00:00 GMT

前言

在这个 AI 模型爆发式成长的时代里，学习与了解 AI 已经成为每个人必不可少的准备。所以我也买了一些平台的 API 接口，但其实用的情况也并不多，大多时候都是去官方 chat 平台使用的，但总不能放着不用浪费掉，我就打算自己也搭一个 chat 平台。而 OpenWebUI，就是一个私有化的 AI 应用平台，它可以很方便地聚合各家的模型，也能轻松地调用 MCP 工具去扩展模型的功能。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 OpenWebUI

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/open_webui/{data,mcpo}/ && cd <path>/open_webui/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open_webui
    ports:
      - "45685:8080"
    volumes:
      - ./data:/app/backend/data
    environment:
      - TZ=Asia/Shanghai
      - AIOHTTP_CLIENT_TIMEOUT=1800
    restart: always

也可自行添加代理，例如：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open_webui
    ports:
      - "45685:8080"
    volumes:
      - ./data:/app/backend/data
    environment:
      - TZ=Asia/Shanghai
      - AIOHTTP_CLIENT_TIMEOUT=1800
      - HTTP_PROXY=http://172.17.0.1:8118
      - HTTPS_PROXY=http://172.17.0.1:8118
      - NO_PROXY=localhost,127.0.0.1
    restart: always

2.3、启动 OpenWebUI

docker compose up -d

暴露端口

sudo ufw allow 45685

然后就可以打开 http://localhost:45685 访问 OpenWebUI 的 Web 页面

2.4、关闭 OpenWebUI

docker compose down

3、配置 https 反向代理

本文以 letsencrypt 证书为演示

[!TIP] 所有 <domain> 请自行替换成个人实际获取证书的域名

sudo nano /etc/nginx/sites-available/open_webui.conf

在其中添加或修改以下内容：

server {
    listen 45658 ssl;
    listen [::]:45658 ssl;
    server_name bysansheng.top;

    ssl_certificate /etc/letsencrypt/live/bysansheng.top/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bysansheng.top/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:ECDHE-RSA-AES128-GCM-SHA256';
    ssl_prefer_server_ciphers off;

    location ~* ^/(auth|api|oauth|admin|signin|signup|signout|login|logout|sso)/ {
        proxy_pass http://localhost:45685;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 10m;
        proxy_buffering off;
        proxy_cache off;
        client_max_body_size 20M;

        proxy_no_cache 1;
        proxy_cache_bypass 1;
        add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0" always;
        add_header Pragma "no-cache" always;
        expires -1;
    }

    # Profile and model images - cached for performance
    location ~ ^/api/v1/(users/[^/]+/profile/image|models/model/profile/image)$ {
        proxy_pass http://localhost:45685;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Cache images for 1 day
        expires 1d;
        add_header Cache-Control "public, max-age=86400";
    }

    location ~* \.(css|jpg|jpeg|png|gif|ico|svg|woff|woff2|ttf|eot)$ {
        proxy_pass http://localhost:45685;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Cache static assets for 7 days
        expires 7d;
        add_header Cache-Control "public, immutable";
    }

    location / {
        proxy_pass http://localhost:45685;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # Extended timeout for long LLM completions (30 minutes)
        proxy_read_timeout 1800;
        proxy_send_timeout 1800;
        proxy_connect_timeout 1800;
        
        proxy_buffering off;
        proxy_cache off;
        client_max_body_size 20M;

        add_header Cache-Control "public, max-age=300, must-revalidate";
    }
}

链接 Nginx

sudo ln -s /etc/nginx/sites-available/open_webui.conf /etc/nginx/sites-enabled/

重启 Nginx

sudo systemctl restart nginx

修改暴露端口

sudo ufw delete allow 45685
sudo ufw allow 45658

然后就可以打开 https://localhost:45658 访问 OpenWebUI 的 Web 页面

4、MCPO

MCP 是一个开放标准和协议，旨在标准化 AI 应用程序与各种数据源之间的连接方式，你可以把它想象成 AI 领域的「USB-C接口」或「驱动程序通用标准」。

而 MCPO 则是一个框架或系统，负责对通过「MCP协议」获取的，并经过处理后的输出结果，进行进一步的整理、格式化、验证和分发。

4.1、镜像的构建

[!TIP] 所有 <mcpo_key> 请自行替换成个人实际选择的密钥

sudo nano ./mcpo/Dockerfile

在其中添加或修改以下内容：

FROM python:3.11-slim
WORKDIR /app

RUN apt-get update && \
    apt-get install -y npm && \
    rm -rf /var/lib/apt/lists/*

RUN pip install mcpo uv

CMD ["sh", "-c", "uvx mcpo --port 8000 --api-key \"${API_KEY}\" --config /app/config.json"]

构建镜像

docker build -t mcpo ./mcpo

也可自行添加代理，例如：

docker build \
  --build-arg HTTP_PROXY=http://172.17.0.1:8118 \
  --build-arg HTTPS_PROXY=http://172.17.0.1:8118 \
  --build-arg NO_PROXY=localhost,127.0.0.1 \
  -t mcpo ./mcpo

4.2、寻找 MCP

首先，前往 https://smithery.ai/server 选择合适的 MCP，这里以 exa 为例

下滑找到 Github 项目地址

仔细阅读文档，并找到相应 json 格式的配置内容，复制备用

[!TIP] 使用 exa 前需要前往 https://dashboard.exa.ai/api-keys 注册 <exa_api_key>

4.3、编写 config 配置文件

sudo nano ./mcpo/config.json

在其中添加或修改 mcpo 配置内容，例如：

{
  "mcpServers": {
    "time-mcp": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    },
    "exa": {
      "command": "npx",
      "args": [
        "-y",
        "exa-mcp-server",
        "tools=get_code_context_exa,web_search_exa,company_research_exa,crawling_exa,linkedin_search_exa,deep_researcher_start,deep_researcher_check"
      ],
      "env": {
        "EXA_API_KEY": "<exa_api_key>"
      }
    }
  }
}

4.4、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open_webui
    ports:
      - "45685:8080"
    volumes:
      - ./data:/app/backend/data
    environment:
      - TZ=Asia/Shanghai
    networks:
      - open-webui-network
    restart: always

  mcpo:
    image: mcpo
    container_name: mcpo
    ports:
      - "49334:8000"
    volumes:
      - ./mcpo/config.json:/app/config.json
      - ./mcpo/cache:/root/.cache/
    environment:
      - TZ=Asia/Shanghai
      - API_KEY=<mcpo_key>
    networks:
      - open-webui-network
    restart: always

networks:
  open-webui-network:
    driver: bridge

4.5、重启 OpenWebUI

docker compose down && docker compose up -d

暴露端口

sudo ufw allow 49334

然后就可以打开 http://localhost:49334/docs 访问 MCPO 的 Web 页面

4.6、应用到 OpenWebUI

打开 OpenWebUI 的 Web 页面，进入 管理员面板 > 设置 > 外部工具

点击右上角的 + 添加链接

填入相应的信息，这里以 exa 为例

最后就可以成功使用添加的 MCP 工具了

Scrutiny 部署教程：硬盘监控面板

Wed, 03 Dec 2025 00:00:00 GMT

前言

对于 NAS 玩家而言，时刻掌握硬盘的各项数据是很有必要的。Scrutiny 正是这样一个轻量、现代化的硬盘监控面板，它可以获取硬盘的 S.M.A.R.T. 信息，并实现自动监控和异常通知。在像我这种没有精力去定期检查硬盘的人眼中，它无疑是很好的利器。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Scrutiny

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/scrutiny/{config,influxdb}/ && cd <path>/scrutiny/config/

2.2、下载 yaml 配置文件

curl -o ./config/scrutiny.yaml https://raw.githubusercontent.com/AnalogJ/scrutiny/master/example.scrutiny.yaml
curl -o ./config/collector.yaml https://raw.githubusercontent.com/AnalogJ/scrutiny/master/example.collector.yaml

也可自行添加代理，例如：

(
    export http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118
    
    curl -o ./config/scrutiny.yaml https://raw.githubusercontent.com/AnalogJ/scrutiny/master/example.scrutiny.yaml
    curl -o ./config/collector.yaml https://raw.githubusercontent.com/AnalogJ/scrutiny/master/example.collector.yaml
)

2.3、编写 docker-compose 配置文件

[!TIP] 需根据个人实际情况在 devices 中挂载相应硬盘

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  scrutiny:
    image: ghcr.io/analogj/scrutiny:master-omnibus
    container_name: scrutiny
    ports:
      - 48085:8080
    volumes:
      - /run/udev:/run/udev:ro
      - ./influxdb:/opt/scrutiny/influxdb
      - ./config:/opt/scrutiny/config
    devices:
      - "/dev/sda"
      - "/dev/sdb"
      - "/dev/sdc"
    cap_add:
      - SYS_ADMIN
      - SYS_RAWIO
    tty: true
    stdin_open: true
    restart: unless-stopped

2.4、启动 Scrutiny

docker compose up -d

暴露端口

sudo ufw allow 48085

然后就可以打开 http://localhost:48085 访问 Scrutiny 的 Web 页面

2.5、关闭 Scrutiny

docker compose down

3、设置通知

Scrutiny 支持多种通知方式

具体配置可以前往 https://github.com/AnalogJ/scrutiny#notifications 查看文档

这里以调用本地脚本为例

3.1、编写脚本

mkdir script && sudo nano ./script/custom_notify.sh

在其中添加或修改相关的脚本内容

<summary>我个人对接的是 OneBot</summary>

[!TIP] 所有 <.*> 请自行替换成个人实际内容

#!/bin/bash

URL="http://127.0.0.1:<port>/send_private_msg"
AUTH_TOKEN="<token>"
USER_ID="<user_id>"

curl -X POST "$URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -d "{\"user_id\": \"$USER_ID\", \"message\": \"【scrutiny】$SCRUTINY_FAILURE_TYPE\n$SCRUTINY_SUBJECT\"}"

</details>

设置运行权限

chmod +x ./script/custom_notify.sh

3.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  scrutiny:
    image: ghcr.io/analogj/scrutiny:master-omnibus
    container_name: scrutiny
    ports:
      - 48085:8080
    volumes:
      - /run/udev:/run/udev:ro
      - ./influxdb:/opt/scrutiny/influxdb
      - ./config:/opt/scrutiny/config
      - ./script:/opt/scrutiny/script
    devices:
      - "/dev/sda"
      - "/dev/sdb"
      - "/dev/sdc"
    cap_add:
      - SYS_ADMIN
      - SYS_RAWIO
    tty: true
    stdin_open: true
    restart: unless-stopped

3.3、编写 scrutiny 配置文件

sudo nano ./config/scrutiny.yaml

在其中添加或修改以下内容：

notify:
  urls:
    - "script:///opt/scrutiny/script/custom_notify.sh"

3.4、重启 Scrutiny

docker compose down && docker compose up -d

3.5、测试通知

curl -X POST http://localhost:48085/api/health/notify

Windows 暂停自动更新

Wed, 03 Dec 2025 00:00:00 GMT

前言

世人苦「Windows 自动更新」已久，试想当某个寂静的夜晚，你在电脑上挂着服务与脚本，准备美美睡一觉，可谁知，第二天迎接你的却是「Windows 已更新」，以及未保存的文档和中断的服务与脚本。

1、清理更新服务

按 <kbd>win</kbd> + <kbd>R</kbd> 并输入 services.msc

找到 Windows Update 禁用

进入 C:\Windows\SoftwareDistribution 并清空文件

重启 Windows Update 服务

2、修改暂停期限

按 <kbd>win</kbd> + <kbd>R</kbd> 并输入 regedit

定位到 \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsUpdate\UX\Settings

然后新建 DWORD 32位值（十进制） 的键值，并将这个键值命名为 FlightSettingsMaxPauseDays，数值改成 3650

3、延长更新

打开 Windows 设置中的更新页面，在下载更新的时候点击 延长 1 周，然后再改成 延长 500 周

Immich 部署教程：自托管照片和视频的管理工具

Sun, 30 Nov 2025 00:00:00 GMT

前言

Immich 是一款高效隐私的，自托管照片和视频的管理工具。但讲真的，我并不认为 Immich 符合我的使用要求，可其它的类似工具，要么就是不如 Immich；要么就是如 MT Photos 一样需要收费。所以，最终我只能勉强选择 Immich 进行使用，不过好在我并不怎么拍照和存储图片与视频，所以大体上也能接受。

1、环境配置

[!TIP] Docker == *
Git LFS == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

1.2、安装 Git LFS

sudo apt update && sudo apt install -y git-lfs

2、部署 Immich

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/immich/ && cd <path>/immich/

2.2、下载配置文件

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
wget -O hwaccel.transcoding.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.transcoding.yml
wget -O hwaccel.ml.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.ml.yml

也可自行添加代理，例如：

(
    export http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118
    
    wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
    wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
    wget -O hwaccel.transcoding.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.transcoding.yml
    wget -O hwaccel.ml.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.ml.yml
)

2.3、修改配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    extends:
      file: hwaccel.transcoding.yml
      service: quicksync
    volumes:
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - .env
    ports:
      - '42283:2283'
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}-openvino
    extends:
      file: hwaccel.ml.yml
      service: openvino
    volumes:
      - model-cache:/cache
    env_file:
      - .env
    restart: always
    healthcheck:
      disable: false

...

2.4、修改环境变量

[!TIP] 所有 <db_password> 请自行替换成个人实际选择的数据库密码

sudo nano .env

在其中修改以下内容：

DB_PASSWORD=<db_password>

2.5、启动 Immich

docker compose up -d

暴露端口

sudo ufw allow 42283

然后就可以打开 http://localhost:42283 访问 Immich 的 Web 页面

2.6、关闭 Immich

docker compose down

3、机器学习模型

[!TIP] 想要使用机器学习，需要先确保当前设备可以正常使用核显或独显。

3.1、准备阶段

创建 CLIP 模型目录

sudo mkdir -p /var/lib/docker/volumes/immich_model-cache/_data/clip/

创建人脸识别模型目录

sudo mkdir -p /var/lib/docker/volumes/immich_model-cache/_data/facial-recognition/

初始化 Git LFS

git lfs install

3.2、下载模型

[!TIP] 所有 <model_url> 请自行替换成个人实际选择的模型下载地址

可以先前往 https://huggingface.co/immich-app 选择要下载的模型

git clone <model_url>

例如：

git clone https://huggingface.co/immich-app/XLM-Roberta-Large-Vit-B-16Plus \
    /var/lib/docker/volumes/immich_model-cache/_data/clip/

git clone https://huggingface.co/immich-app/buffalo_l \
    /var/lib/docker/volumes/immich_model-cache/_data/facial-recognition/

也可自行添加代理，例如：

(
    export http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118
    
    git clone https://huggingface.co/immich-app/XLM-Roberta-Large-Vit-B-16Plus \
        /var/lib/docker/volumes/immich_model-cache/_data/clip/

    git clone https://huggingface.co/immich-app/buffalo_l \
        /var/lib/docker/volumes/immich_model-cache/_data/facial-recognition/
)

3.3、开启机器学习

打开 Immich 的 Web 页面，进入 系统管理 > 设置，展开 机器学习设置

然后展开 智能搜索，选择相应模型，点击 启用智能搜索

接着展开 人脸识别，选择相应模型，点击 启用人脸识别

4、外部图库

4.1、挂载外部图库

[!TIP] 所有 <library_path> 请自行替换成个人实际外部图库路径
所有 <library_mount> 请自行替换成个人实际外部图库挂载点

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    extends:
      file: hwaccel.transcoding.yml
      service: quicksync
    volumes:
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
      - <library_path>:<library_mount>
    env_file:
      - .env
    ports:

...

重启 Immich

docker compose down && docker compose up -d

4.2、导入外部图库

打开 Immich 的 Web 页面，进入 系统管理 > 外部图库

点击 创建图库，然后选择图库所有者，点击 创建

再填入图库路径，点击 添加

最后找到新添加的图库，开启 扫描，就可以让外部图库的内容加入到你的 Immich 图库里

5、客户端

Immich 不仅提供了安卓客户端，也可以通过在 App Store 搜索 immich 来安装 iOS 客户端。

Kikoeru 部署教程：自建 ASMR 服务器

Fri, 28 Nov 2025 00:00:00 GMT

前言

Kikoeru 是我目前唯一见到的，一款专门为 ASMR 设计的服务器项目，虽然有多个底层架构不同的分支，但总归都是叫这个名字，都是一套接近的 UI。我当前使用的是 number178 所编写和构建的 Kikoeru。并且我自己也写了个程序，可以通过 Aria2 去下载 AsmrOne 的资源。当然，这一套折腾下来，我更多的是享受折腾本身的乐趣，反而 ASMR 倒是不怎么听的。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Kikoeru

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/kikoeru/{sqlite,covers,config}/ && cd <path>/kikoeru/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <voice_path> 请自行替换成个人实际「ASMR库」路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  kikoeru:
    image: number17/kikoeru:latest
    container_name: kikoeru
    ports:
      - 48488:8888
    volumes:
      - ./sqlite:/usr/src/kikoeru/sqlite
      - ./covers:/usr/src/kikoeru/covers
      - ./config:/usr/src/kikoeru/config
      - <voice_path>:/usr/src/kikoeru/VoiceWork
    restart: unless-stopped

2.3、启动 Kikoeru

docker compose up -d

暴露端口

sudo ufw allow 48488

然后就可以打开 http://localhost:48488 访问 Kikoeru 的 Web 页面

2.4、关闭 Kikoeru

docker compose down

3、修改样式

修改样式的目的是为了美化 Kikoeru 的页面，当然，是以我的审美为主的。

原版：

修改：

获取 CSS 文件名

docker exec -it kikoeru find / -type f -name "index.*.css"

提取 CSS 文件

[!TIP] 所有 <app_filename> 请自行替换成个人实际获取的 CSS 文件名，例如 app.892d7287.css

docker cp kikoeru:/usr/src/kikoeru/dist/css/<app_filename> ./app.css

修改 CSS 文件

sudo nano app.css

在其中添加或修改以下内容：

...

.q-layout__section--marginal { background-color: #000000; }
aside.q-drawer div.q-scrollarea>div.scroll>div { height: 0; }
.q-mx-sm { margin-left: 18px;margin-right: 18px;margin-top: 8px; }
.q-drawer--left.q-drawer--bordered { border-right: 0; }
.q-field--outlined .q-field__control:before { border-width: 2px; }
.scroll { overflow: hidden; }

注入 CSS 文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  kikoeru:
    image: number17/kikoeru:latest
    container_name: kikoeru
    ports:
      - 48488:8888
    volumes:
      - ./sqlite:/usr/src/kikoeru/sqlite
      - ./covers:/usr/src/kikoeru/covers
      - ./config:/usr/src/kikoeru/config
      - ./app.css:/usr/src/kikoeru/dist/css/<app_filename>
      - <voice_path>:/usr/src/kikoeru/VoiceWork
    restart: unless-stopped

重启 Kikoeru

docker compose down && docker compose up -d

4、导入「ASMR库」

打开 Komga 的 Web 页面，进入 设定 > 音色库

在 添加新文件夹 的 绝对路径 里填入 /usr/src/kikoeru/VoiceWork，然后点击 添加

4、扫描「ASMR库」

[!TIP] Kikoeru 貌似并不支持自动扫描文件夹，每次导入新的专辑，都需要手动开启一次扫描。

打开 Komga 的 Web 页面，进入 设定 > 扫描

然后点击 扫描本地音色库

5、iOS 客户端

Kikoeru 专门推出了一个 iOS 客户端，具体可以前往 https://number17.online/docs/kikoeru-app 查看，相关流程和使用教程都在里面。

Audiobookshelf 部署教程：自建有声书服务器

Mon, 24 Nov 2025 00:00:00 GMT

前言

Audiobookshelf 是少见的，为有声书和播客专门设计的服务器项目。我个人是从不听播客的，倒是比较常听有声书。关于有声书的获取方案，我目前是从喜马拉雅上下载加密音频文件，然后再解码成 MP3 / M4A 文件，整理导入 Audiobookshelf 中收听。这样其实是有点麻烦的，因为喜马拉雅有一定下载限制，可能下一部一千多集的有声书，就要花费十五分钟守在电脑前。当然，我是觉得无所谓的，毕竟折腾本身就是一种乐趣。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Audiobookshelf

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/audiobookshelf/ && cd <path>/audiobookshelf/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <audiobooks_path> 请自行替换成个人实际有声书库路径
所有 <podcasts_path> 请自行替换成个人实际播客库路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - 43378:80
    volumes:
      - ./config:/config
      - ./metadata:/metadata
      - <audiobooks_path>:/audiobooks
      - <podcasts_path>:/podcasts
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

2.3、启动 Audiobookshelf

docker compose up -d

暴露端口

sudo ufw allow 43378

然后就可以打开 http://localhost:43378 访问 Audiobookshelf 的 Web 页面

2.4、关闭 Audiobookshelf

docker compose down

3、媒体库的添加

要进行媒体库的添加，请打开 Emby 的 Web 页面，进入 设置 > 媒体库，点击 添加库

然后根据自己的喜好进行配置，最后点击 创建

<summary>这是我本人的常用配置</summary>

</details>

4、关于封面

Audiobookshelf 支持识别文件夹中的 cover 作为专辑封面

例如：

超级惊悚直播_有声的紫襟/
├── 第1章 女孩的委托.m4a
├── 第2章 阴间秀场.m4a
├── 第3章 惊悚面试.m4a

加入封面后：

超级惊悚直播_有声的紫襟/
├── cover.jpg
├── 第1章 女孩的委托.m4a
├── 第2章 阴间秀场.m4a
├── 第3章 惊悚面试.m4a

如果你是导入喜马拉雅的有声书，那么你可以前往 https://www.ximalaya.com，搜索你导入的专辑，点进去。

按 <kbd>F12</kbd>，找到封面元素，然后就可以根据链接进行图片的保存

5、客户端

Audiobookshelf 专门推出了一个 Android & iOS 客户端，具体可以前往 https://github.com/advplyr/audiobookshelf-app 查看，相关流程和使用教程都在里面。

it-tools 部署教程：程序员的瑞士军刀

Mon, 24 Nov 2025 00:00:00 GMT

前言

it-tools 是一款专门为程序员设计的工具箱，也被称作是程序员的瑞士军刀。我个人常用的功能有：随机端口生成，docker run 转换 docker compose，json 格式化等。

唯一要吐槽的是，它的「docker run 转换 docker compose」的 Tab 是 4 格的，而我的 docker-compose.yml 常用的 Tab 是 2 格的，我见到的大多数人和 AI 基本也都是以 2 格为主。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 it-tools

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/it_tools/ && cd <path>/it_tools/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  it-tools:
    image: corentinth/it-tools:latest
    container_name: it_tools
    ports:
      - 42151:80
    restart: unless-stopped

2.3、启动 it-tools

docker compose up -d

暴露端口

sudo ufw allow 42151

然后就可以打开 http://localhost:42151 访问 it-tools 的 Web 页面

2.4、关闭 it-tools

docker compose down

3、修改样式

修改样式的目的主要是为了去除例如「赞助」、「Twitter 账号」这样的多余元素

获取 CSS 文件名

docker exec -it it_tools find /usr/share/nginx/html/assets/ -name "index*.css" -exec basename {} \; | head -1

提取 CSS 文件

[!TIP] 所有 <index_filename> 请自行替换成个人实际获取的 CSS 文件名，例如 index-f0f4dd3b.css

docker cp it_tools:/usr/share/nginx/html/assets/<index_filename> ./index.css

修改 CSS 文件

sudo nano index.css

在其中添加或修改以下内容：

...

button.c-button.circle svg:has(path[d="m12 21.35l-1.45-1.32C5.4 15.36 2 12.27 2 8.5C2 5.41 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.08C13.09 3.81 14.76 3 16.5 3C19.58 3 22 5.41 22 8.5c0 3.77-3.4 6.86-8.55 11.53L12 21.35Z"]),
a.c-button.round.support-button,
a.c-button.circle[aria-label="UI 库"],
a.c-button.circle[aria-label="Twitter 账号"] {
    display: none !important;
}

注入 CSS 文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  it-tools:
    image: corentinth/it-tools:latest
    container_name: it_tools
    ports:
      - 42151:80
    volumes:
      - ./index.css:/usr/share/nginx/html/assets/<index_filename>
    restart: unless-stopped

重启 it-tools

docker compose down && docker compose up -d

FlareSolverr 部署教程：绕过 Cloudflare 的反爬虫保护

Sat, 22 Nov 2025 00:00:00 GMT

前言

FlareSolverr 是一个用于绕过 Cloudflare 反爬虫保护的工具。其核心工作原理是模拟一个真实的浏览器，当你向它发送请求后，它会在后台启动一个基于 Chrome 的浏览器实例，访问你指定的目标 URL，并自动完成 Cloudflare 设置的验证挑战。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 FlareSolverr

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/flaresolverr/config && cd <path>/flaresolverr/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    ports:
      - 8191:8191
    environment:
      - LOG_LEVEL=info
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/config
    restart: unless-stopped

也可自行添加代理，例如：

services:
  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    ports:
      - 8191:8191
    environment:
      - LOG_LEVEL=info
      - TZ=Asia/Shanghai
      - HTTP_PROXY=http://172.17.0.1:8118
      - HTTPS_PROXY=http://172.17.0.1:8118
      - NO_PROXY=localhost,127.0.0.1
    volumes:
      - ./config:/config
    restart: unless-stopped

2.3、启动 FlareSolverr

docker compose up -d

2.4、关闭 FlareSolverr

docker compose down

3、使用示例

3.1、直接使用

curl -X POST "http://127.0.0.1:8191/v1" \
  -H "Content-Type: application/json" \
  -d '{
    "cmd": "request.get",
    "url": "https://www.google.com/",
    "maxTimeout": 180000
  }'

3.2、通过会话来使用

[!TIP] 所有 <session_id> 请自行替换成个人实际选择的「会话ID」

创建会话

curl -X POST "http://127.0.0.1:8191/v1" \
  -H "Content-Type: application/json" \
  -d '{
    "cmd": "sessions.create",
    "session": "<session_id>",
  }'

使用会话

curl -X POST "http://127.0.0.1:8191/v1" \
  -H "Content-Type: application/json" \
  -d '{
    "cmd": "request.get",
    "url": "https://www.google.com/",
    "session": "<session_id>",
    "maxTimeout": 180000
  }' \
  --max-time 180

删除会话

curl -X POST "http://127.0.0.1:8191/v1" \
  -H "Content-Type: application/json" \
  -d '{
    "cmd": "sessions.destroy",
    "session": "<session_id>",
  }'

HomeBox 部署教程：内网测速工具

Sat, 22 Nov 2025 00:00:00 GMT

前言

HomeBox 是一个内网测速工具，常用于组建家庭局域网时，对网络进行持续压测，支持自定义发包大小、指定线程数量等。相关的测速工具很多，比如 iperf3、Speedtest，但是我个人更喜欢 HomeBox，它上手简单，UI 界面也十分直观。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 HomeBox

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/homebox/ && cd <path>/homebox/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  homebox:
    image: xgheaven/homebox
    container_name: homebox
    ports:
      - 43300:3300
    restart: unless-stopped

2.3、启动 HomeBox

docker compose up -d

暴露端口

sudo ufw allow 43300

然后就可以打开 http://localhost:43300 访问 HomeBox 的 Web 页面

2.4、关闭 HomeBox

docker compose down

3、自定义选项

3.1、单位

HomeBox 的测速单位分为 B/s 和 b/s，而 1B/s = 8b/s。像我们日常所说的宽带 1000M，500M，100M，其实就是 b/s。

3.2、传输配置

HomeBox 支持自定义发包大小、指定线程数量，其中 Pack Count 就是传输包的大小，Parallel 就是传输线程数量

Komga 部署教程：自建漫画服务器

Sat, 22 Nov 2025 00:00:00 GMT

前言

Komga 是一款免费和开源的漫画服务器项目，可以管理本地 CBZ、CBR、PDF 和 EPUB 格式的漫画文件，支持在线阅读和编辑书籍的元数据，也有对系列漫画归档的设计。

支持 OPDS v1 和 v2 协议
可与 Kobo 阅读器同步，也支持 KOReader 同步
提供 REST API，方便工具和脚本与之交互

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Komga

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/komga/config/ && cd <path>/komga/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <comic_path> 请自行替换成个人实际漫画库路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  komga:
    image: gotson/komga:latest
    container_name: komga
    ports:
      - 45600:25600
    environment:
      - UID=0
      - GID=0
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/config
      - <comic_path>:/comic
    restart: unless-stopped

2.3、启动 Komga

docker compose up -d

暴露端口

sudo ufw allow 45600

然后就可以打开 http://localhost:45600 访问 Komga 的 Web 页面

2.4、关闭 Komga

docker compose down

3、导入漫画库

打开 Komga 的 Web 页面，点击 库 旁边的 +，然后根据自己的喜好进行配置，最后 添加

<summary>这是我本人的常用配置</summary>

</details>

LANraragi 部署教程：自建本子服务器

Sat, 22 Nov 2025 00:00:00 GMT

前言

LANraragi 是一款多平台开源的漫画服务器项目，和 Komga 相比，它更加轻量与迅捷。只不过其本身并没有对系列漫画归档的设计，所以对于普通漫画来说不太友好。但想必你也能从它的 UI 看出，它是模仿 Ehentai 而设计的，更偏向于本子的存储与展示。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 LANraragi

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/lanraragi/{thumb,database,plugin}/ && cd <path>/lanraragi/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <comic_path> 请自行替换成个人实际漫画库路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  lanraragi:
    image: difegue/lanraragi
    container_name: lanraragi
    ports:
      - 43434:3000
    volumes:
      - ./thumb:/home/koyomi/lanraragi/thumb
      - ./database:/home/koyomi/lanraragi/database
      - ./plugin:/home/koyomi/lanraragi/lib/LANraragi/Plugin/Sideloaded
      - <comic_path>:/home/koyomi/lanraragi/content
    restart: unless-stopped

2.3、启动 LANraragi

docker compose up -d

暴露端口

sudo ufw allow 43434

然后就可以打开 http://localhost:43434 访问 LANraragi 的 Web 页面

[!NOTE] 默认密码：kamimamita

2.4、关闭 LANraragi

docker compose down

3、修改默认语言

LANraragi 是不支持修改默认语言的，它会根据浏览器的 Accept-Language 自动切换语言。我个人感觉中文版页面做的并不太好，所以需要通过 Nginx 来实现设置英语为强制语言。

sudo nano /etc/nginx/sites-available/lanraragi.conf

在其中添加或修改以下内容：

server {
    listen 43430;
    listen [::]:43430;
    server_name _;

    location / {
        proxy_pass http://localhost:43434;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        
        proxy_set_header Accept-Language "en-US,en;q=0.9";
    }
}

链接 Nginx

sudo ln -s /etc/nginx/sites-available/lanraragi.conf /etc/nginx/sites-enabled/

重启 Nginx

sudo systemctl restart nginx

修改暴露端口

sudo ufw delete allow 43434
sudo ufw allow 43430

然后就可以打开 http://localhost:43430 访问 LANraragi 的 Web 页面

4、插件配置

打开 LANraragi 的 Web 页面，进入 Settings > Plugin Configuration，即可修改 LANraragi 的插件配置

4.1、启用 ComicInfo 插件

LANraragi 并不像 Komga 那样，默认可以直接读取漫画文件内的 ComicInfo.xml，想要使用这个功能，需要在插件配置中手动开启。

打开 LANraragi 的插件配置页面，展开 Metadata Plugins，找到 ComicInfo 并启用。

Navidrome 部署教程：自建音乐服务器

Sat, 22 Nov 2025 00:00:00 GMT

前言

Navidrome 是一个开源的基于 Web 的音乐收藏服务器项目和流媒体播放器，它让人可以随时随地通过任意浏览器或移动设备畅听个人音乐库，宛如专属的私人 Spotify / Apple Music。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 Navidrome

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/navidrome/data/ && cd <path>/navidrome/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <music_path> 请自行替换成个人实际音乐库路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    ports:
      - 44533:4533
    environment:
      - ND_SCANINTERVAL=1m
      - ND_LOGLEVEL=info
    volumes:
      - ./data:/data
      - <music_path>:/music
    restart: unless-stopped

2.3、启动 Navidrome

docker compose up -d

暴露端口

sudo ufw allow 44533

然后就可以打开 http://localhost:44533 访问 Navidrome 的 Web 页面

2.4、关闭 Navidrome

docker compose down

PairDrop 部署教程：通过浏览器实现点对点的文件传输

Sat, 22 Nov 2025 00:00:00 GMT

前言

PairDrop 支持通过浏览器实现局域网或互联网环境下的点对点文件传输，是基于 Snapdrop 二次开发的工具，灵感源自苹果的 AirDrop。

堪称文件传输的瑞士军刀：

家庭共享：手机平板电脑互传全家桶
会议救场：现场演示资料秒发全场
运维利器：服务器日志直传手机查看

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 PairDrop

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/pairdrop/ && cd <path>/pairdrop/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  pairdrop:
    image: linuxserver/pairdrop:latest
    container_name: pairdrop
    ports:
      - 43049:3000
    environment:
      - PUID=0
      - PGID=0
      - WS_FALLBACK=false
      - RATE_LIMIT=false
      - RTC_CONFIG=false
      - DEBUG_MODE=false
      - TZ=Asia/Shanghai
    restart: unless-stopped

2.3、启动 PairDrop

docker compose up -d

暴露端口

sudo ufw allow 43049

然后就可以打开 http://localhost:43049 访问 PairDrop 的 Web 页面

2.4、关闭 PairDrop

docker compose down

ddns-go 部署教程：动态域名解析工具

Sat, 22 Nov 2025 00:00:00 GMT

前言

ddns-go 是一款简单好用的动态域名解析工具，它可以帮助你自动将域名解析到「公网IP」。比如你希望在本地部署网站，但是因为「公网IP」是动态的，一直前往 DNS 控制台更改 DNS 解析就会很繁琐。而 ddns-go 就能很好的解决这一难题，帮助你自动修改 DNS 解析。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 ddns-go

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/ddns_go/data/ && cd <path>/ddns_go/

2.2、编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  ddns-go:
    image: jeessy/ddns-go:latest
    container_name: ddns-go
    network_mode: host
    volumes:
      - ./data:/root
    restart: unless-stopped

2.3、启动 ddns-go

docker compose up -d

暴露端口

sudo ufw allow 9876

然后就可以打开 http://localhost:9876 访问 ddns-go 的 Web 页面

2.4、关闭 ddns-go

docker compose down

3、基础配置

首先，选择你的 DNS 服务商，并填写相关密钥。

然后，自行选择 IPv4 和 IPv6 的启用，以及获取 IP 的方式，并在 Domains 里填写你需要解析到此服务器的域名。

其他配置里面，一般不建议开启公共访问，如需开启，请做好防护准备。

通过 s3fs 挂载对象存储到本地

Mon, 17 Nov 2025 00:00:00 GMT

前言

我始终认为对象存储和网盘相比，是更适合存储文件的一种形式。刚好我从朋友那白嫖了 15TB 的对象存储，遂记录下如何通过 s3fs 把对象存储挂载到本地。

1、安装 s3fs

apt install -y s3fs

2、配置密钥

[!TIP] 所有 <ak> 请自行替换成个人实际 Access Key
所有 <sk> 请自行替换成个人实际 Secret Key

echo <ak>:<sk> > /root/.cache/.passwd
chmod 600 /root/.cache/.passwd

3、创建挂载点

[!TIP] 所有 <s3fs_name> 请自行替换成个人实际的本地挂载名称

sudo mkdir /mnt/<s3fs_name>

4、启动 s3fs

[!TIP] 所有 <bucket_name> 请自行替换成个人实际要挂载的桶名称
所有 <url> 请自行替换成个人实际的文件网关

sudo nano /etc/systemd/system/<s3fs_name>.service

在其中添加或修改以下内容：

[Unit]
Description=S3FS Service
After=network.target

[Service]
Type=forking
ExecStart=/usr/bin/s3fs <bucket_name> /mnt/<s3fs_name>/ \
    -o passwd_file=/root/.cache/.passwd \
    -o url=<url> \
    -o use_path_request_style
ExecStop=/bin/fusermount -u /mnt/<s3fs_name>/
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

启动服务

sudo systemctl daemon-reload
sudo systemctl enable --now <s3fs_name>

通过 ssh 打通云服务器 socks 通道进行代理

Mon, 17 Nov 2025 00:00:00 GMT

前言

前文说到，大部分 IDC 的云服务器对于自建代理节点有着严格限制，但也不是没有备选方案，比如通过 ssh 的连接打通 socks 通道进行代理，只不过这样的速度会慢很多，但也聊胜于无。本文将介绍如何通过 autossh 自动创建 socks5 通道，以及通过 privoxy 转换成 http 通道。

1、部署 autossh

1.1、安装 autossh

sudo apt update && sudo apt install -y autossh

1.2、将公钥上传到云服务器

[!TIP] 所有 <ip> 请自行替换成个人实际的云服务器 IP

ssh-keygen -t ed25519
ssh-copy-id root@<ip> # 除了要输入密码的时候，其它都按回车

1.3、启动 autossh

sudo nano /etc/systemd/system/autossh.service

在其中添加或修改以下内容：

[Unit]
Description=AutoSSH Service
After=network.target

[Service]
User=root
ExecStart=/usr/bin/autossh -M 0 -D 0.0.0.0:1080 -N root@<ip> -p 22 \
  -o ExitOnForwardFailure=yes -o "ServerAliveInterval 30" -o "ServerAliveCountMax 3"
Restart=always

[Install]
WantedBy=multi-user.target

暴露端口

sudo ufw allow 1080

启动服务

sudo systemctl daemon-reload
sudo systemctl enable --now autossh

1.4、设置定时重启

sudo sh -c 'echo "0 */4 * * * root /bin/systemctl restart autossh" >> /etc/crontab'

验证任务

grep autossh /etc/crontab

2、部署 privoxy

2.1、安装 privoxy

sudo apt update && sudo apt install -y privoxy

2.2、配置 privoxy

sudo nano /etc/privoxy/config

在其中修改以下内容：

# 启用监听地址
listen-address  0.0.0.0:8118

# 在文件末尾添加转发规则
forward-socks5t / 127.0.0.1:1080 .

暴露端口

sudo ufw allow 8118

2.3、重启 privoxy

sudo systemctl restart privoxy
sudo systemctl enable privoxy

3、使用示例

3.1、使用 socks 代理

curl -x socks5h://127.0.0.1:1080 https://www.google.com

import requests

requests.get(
    url="https://www.google.com",
    proxies={
        "http": "socks5h://127.0.0.1:1080", 
        "https": "socks5h://127.0.0.1:1080"
    },
    timeout=60
)

3.2、使用 http 代理

curl -x http://127.0.0.1:8118 https://www.google.com

http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118 \
  wget https://github.com/fluidicon.png

Ubuntu 配置 DNS

Sun, 16 Nov 2025 00:00:00 GMT

前言

虽然我家已经通过软路由实现了使用自建 DNS 的统一网络代理，但是由于种种考量，我的 NAS 并没有接入。这就导致在 NAS 进行某些程序单独配置代理时，有时会遇到 DNS 污染，所以需要自行修改 DNS，本文是关于我配置 DNS 的记录。

1、安装 resolvconf

sudo apt update && sudo apt install -y resolvconf

2、配置 DNS

[!TIP] 所有 <ip> 请自行替换成个人实际选择的 DNS

sudo nano /etc/resolvconf/resolv.conf.d/head

在其中添加以下几行：

nameserver <ip>

例如：

nameserver 8.8.8.8
nameserver 2001:4860:4860::8888
nameserver 8.8.4.4
nameserver 2001:4860:4860::8844

3、应用 DNS

sudo systemctl restart resolvconf
sudo resolvconf -u
sudo systemctl restart systemd-resolved

<!-- ```bash sudo apt purge resolvconf sudo apt autoremove sudo systemctl restart systemd-resolved

Ubuntu 挂载新硬盘

Sun, 16 Nov 2025 00:00:00 GMT

前言

最近在闲鱼上淘了一块 2TB 的「镁光1100」固态硬盘，虽然是几年前的老古董了，但是价格只要 550，所以我准备给它挂到我的 NAS 上跑 PT，本文是对于我个人挂载新硬盘的记录。

1、挂载

1.1、确认硬盘的设备名称

sudo fdisk -l

1.2、清除硬盘

[!TIP] 所有 <sdX> 请自行替换成个人实际的硬盘设备名称

sudo wipefs -a /dev/<sdX>

1.3、格式化硬盘

sudo mkfs.ext4 /dev/<sdX>  # 可选其他文件系统（如 ntfs、xfs）

1.4、创建挂载点

[!TIP] 所有 <name> 请自行替换成个人实际的硬盘挂载名称

sudo mkdir /mnt/<name>

1.5、系统挂载

获取硬盘 uuid

sudo blkid /dev/<sdX>

修改 fstab 文件

sudo nano /etc/fstab

在文件末尾添加：

UUID=<uuid> /mnt/<name> ext4 defaults 0 2

例如：

UUID=1498ac8c-20f9-41a7-a0e9-4cb4c6f1cd2a /mnt/870evo ext4 defaults 0 2
UUID=82cdc352-36ce-491a-bf4d-eee10418d35f /mnt/sc001xt_1 ext4 defaults 0 2
UUID=dac7aff6-7cf6-4cdb-a069-935a658b3b87 /mnt/sc001xt_2 ext4 defaults 0 2
UUID=39432d77-f57d-420c-9dc6-0c96acb38c43 /mnt/micron1100 ext4 defaults 0 2

1.6、测试挂载配置

sudo mount -a

如果没有报错，则表示配置正确

2、卸载

在 fstab 文件中删除挂载信息

sudo nano /etc/fstab

然后卸除挂载

sudo umount /mnt/<name>
sudo rmdir /mnt/<name>

使用 frp 进行内网穿透

Sun, 16 Nov 2025 00:00:00 GMT

前言

要让自己的局域网设备实现内网穿透，首先得有一台带公网 IP 的云服务器，这里推荐雨云。

1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/frp/ && cd <path>/frp/

2、下载 frp

前往 https://github.com/fatedier/frp/releases 选择合适的版本

::github{repo="fatedier/frp"}

然后下载相应的文件

wget -O frp.tar.gz <url>

例如：

wget -O frp.tar.gz https://github.com/fatedier/frp/releases/download/v0.65.0/frp_0.65.0_linux_amd64.tar.gz

也可自行添加代理，例如：

http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118 \
  wget -O frp.tar.gz https://github.com/fatedier/frp/releases/download/v0.65.0/frp_0.65.0_linux_amd64.tar.gz

解压文件

tar -zxvf frp.tar.gz --one-top-level=frp --strip-components=1 && rm -rf frp.tar.gz

3、配置服务端

3.1、修改配置文件

[!TIP] 所有 <token> 请自行替换成个人实际选择的密钥

sudo nano frps.toml

在其中添加以下几行：

[common]
bind_port = 7000
token = <token>

暴露端口

sudo ufw allow 7000

3.2、运行 frps

sudo nano /etc/systemd/system/frps.service

在其中添加以下几行：

[Unit]
Description=Frp Server
After=network.target

[Service]
User=root
ExecStart=<path>/frp/frps -c <path>/frp/frps.toml
Restart=always

[Install]
WantedBy=multi-user.target

设置运行权限

chmod +x frps

启动服务

sudo systemctl daemon-reload
sudo systemctl enable --now frps

4、配置客户端

4.1、修改配置文件

[!TIP] 所有 <ip> 请自行替换成个人实际的服务器 ip
所有 <token> 请自行替换成个人实际选择的密钥
所有 <local_port> 请自行替换成个人实际本地端口
所有 <remote_port> 请自行替换成个人实际穿透端口

sudo nano frpc.toml

在其中添加或修改以下内容：

[common]
server_addr = <ip>
server_port = 7000
token = <token>

[<name>]
type = tcp
local_ip = 127.0.0.1
local_port = <local_port>
remote_port = <remote_port>

4.2、运行 frpc

sudo nano /etc/systemd/system/frpc.service

在其中添加或修改以下内容：

[Unit]
Description=Frp Server
After=network.target

[Service]
User=root
ExecStart=<path>/frp/frpc -c <path>/frp/frpc.toml
Restart=always

[Install]
WantedBy=multi-user.target

设置运行权限

chmod +x frpc

启动服务

sudo systemctl daemon-reload
sudo systemctl enable --now frpc

使用 NUT 连接 UPS：保护 NAS 的硬盘

Sun, 16 Nov 2025 00:00:00 GMT

前言

我的 NAS 使用的 UPS 是 BK650M2，说实话，用了这么久，也就碰上过一次跳匝，所以只派上过用场一次。但是硬盘保护这种事，有一次闪失便会有不可逆的损伤，也算是提前做好应对风险的准备。

1、检查 ups 连接

[!TIP] 首先，要确保 UPS 的通讯线连接到 NAS 的 usb 数据口上。

lsusb | grep "American Power Conversion"

2、安装 NUT

sudo apt update && sudo apt install -y nut

3、修改配置文件

3.1、配置 NUT 运行模式

sudo nano /etc/nut/nut.conf

在其中添加或修改以下内容：

MODE=standalone

3.2、配置 UPS 驱动

sudo nano /etc/nut/ups.conf

在其中添加或修改以下内容，这里以 BK650M2 为主：

[bk650m2]
    driver = usbhid-ups
    port = auto
    pollinterval = 10
    pollfreq = 15
    desc = "BK650M2 UPS"

    ignorelb

    # 电量小于 30% 时强制关机
    override.battery.charge.low = 30
    
    # 剩余运行时间小于 10 分钟时关机
    override.battery.runtime.low = 600

测试驱动

sudo upsdrvctl start

3.3、配置用户

[!TIP] 所有 <password> 请自行替换成个人实际选择的密码

sudo nano /etc/nut/upsd.users

在其中添加或修改以下内容：

[upsmon]
    password = <password>
    upsmon master

3.4、配置监听网络接口

sudo nano /etc/nut/upsd.conf

在其中添加或修改以下内容：

LISTEN 0.0.0.0 3493

3.5、配置本地监控

sudo nano /etc/nut/upsmon.conf

在其中添加或修改以下内容：

MONITOR bk650m2@localhost 1 upsmon <password> master
NOTIFYCMD /usr/sbin/upssched
NOTIFYFLAG ONLINE SYSLOG+WALL+EXEC
NOTIFYFLAG ONBATT SYSLOG+WALL+EXEC

添加设备访问权限

sudo usermod -a -G nut $USER

3.6、配置自定义事件

* 3.6.1、编写处理脚本

sudo nano /etc/nut/upssched-cmd.sh

在其中添加或修改以下内容：

#!/bin/bash

case $1 in
  power-off)
    logger -t upssched-cmd "UPS on battery for 180s, forcing shutdown"
    /usr/sbin/upsmon -c fsd
    ;;
  *)
    logger -t upssched-cmd "Unrecognized upssched command: $1"
    ;;
esac

设置运行权限

sudo chmod +x /etc/nut/upssched-cmd.sh

* 3.6.2、修改相关配置

sudo nano /etc/nut/upssched.conf

在其中添加或修改以下内容：

CMDSCRIPT /etc/nut/upssched-cmd.sh
PIPEFN /run/nut/upssched.pipe
LOCKFN /run/nut/upssched.lock
AT ONBATT * START-TIMER power-off 180
AT ONLINE * CANCEL-TIMER power-off

3.7 修改 systemd 配置

* 3.7.1 修改 nut-server 配置

sudo mkdir -p /etc/systemd/system/nut-server.service.d/
sudo nano /etc/systemd/system/nut-server.service.d/override.conf

在其中添加或修改以下内容：

[Unit]
Description=Network UPS Tools - power devices information server
After=network.target nut-driver.service
Before=nut-monitor.service

[Service]
Restart=always
RestartSec=10
StartLimitInterval=200
StartLimitBurst=5

[Install]
WantedBy=multi-user.target

* 3.7.2 修改 nut-monitor 配置

sudo mkdir -p /etc/systemd/system/nut-monitor.service.d/
sudo nano /etc/systemd/system/nut-monitor.service.d/override.conf

在其中添加或修改以下内容：

[Unit]
Description=Network UPS Tools - power device monitor and shutdown controller
After=network.target nut-server.service

[Service]
Restart=always
RestartSec=10
StartLimitInterval=200
StartLimitBurst=5
ExecStartPre=/bin/sleep 5

[Install]
WantedBy=multi-user.target

4、启动 NUT

sudo systemctl daemon-reload
sudo systemctl restart nut-driver nut-server nut-monitor
sudo systemctl enable nut-driver nut-server nut-monitor

验证状态

upsc bk650m2@localhost

5、设置定时重启

sudo sh -c 'echo "0 */3 * * * root /bin/systemctl restart nut-driver" >> /etc/crontab'
sudo sh -c 'echo "0 */3 * * * root /bin/systemctl restart nut-server" >> /etc/crontab'
sudo sh -c 'echo "0 3 * * * root /bin/systemctl restart nut-monitor" >> /etc/crontab'

验证任务

grep nut /etc/crontab

6、断电测试

查看日志

sudo journalctl -f -u nut-monitor

模拟断电，先拔掉 UPS 电源插头，然后观察日志

[!NOTE] 确认行为：
1、延迟几秒后状态切换为电池供电
2、电量或时间阈值触发后，系统应自动关机

Openlist 搭建教程：一款优秀的文件列表工具

Sun, 16 Nov 2025 00:00:00 GMT

前言

Openlist 是一个支持多种存储的文件列表工具，可用于更好地管理文件和资源。我本人并没有那么多网盘需要聚合，部署 Openlist 也就是看看本地文件和对象存储了，但不可否认的是，Openlist 确实很好用，也很方便。

1、部署 Openlist

1.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/openlist/{data} && cd <path>/openlist/

1.2、下载 Openlist

前往 https://github.com/OpenListTeam/OpenList/releases 选择合适的版本

::github{repo="OpenListTeam/OpenList"}

然后下载相应的文件

wget -O openlist.tar.gz <url>

例如：

wget -O openlist.tar.gz https://github.com/OpenListTeam/OpenList/releases/download/beta/openlist-linux-amd64.tar.gz

也可自行添加代理，例如：

http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118 \
  wget -O openlist.tar.gz https://github.com/OpenListTeam/OpenList/releases/download/beta/openlist-linux-amd64.tar.gz

解压文件

tar -zxvf openlist.tar.gz --one-top-level=openlist --strip-components=1 && rm -rf openlist.tar.gz

设置运行权限

chmod +x openlist

1.3、启动 Openlist

sudo nano /etc/systemd/system/openlist.service

在其中添加或修改以下内容：

[Unit]
Description=OpenList Service
After=network.target

[Service]
User=root
WorkingDirectory=<path>/openlist/
ExecStart=<path>/openlist server
Restart=on-failure

[Install]
WantedBy=multi-user.target

也可自行添加代理，例如：

[Unit]
Description=OpenList Service
After=network.target

[Service]
User=root
WorkingDirectory=<path>/openlist/
Environment="HTTP_PROXY=http://127.0.0.1:8118"
Environment="HTTPS_PROXY=http://127.0.0.1:8118"
Environment="NO_PROXY=localhost,127.0.0.1"
ExecStart=<path>/openlist server
Restart=on-failure

[Install]
WantedBy=multi-user.target

启动服务

sudo systemctl daemon-reload
sudo systemctl enable --now openlist

1.4、链接 SSL 证书

本文以 letsencrypt 证书为演示

[!TIP] 所有 <domain> 请自行替换成个人实际获取证书的域名

ln -s /etc/letsencrypt/live/<domain>/fullchain.pem ./data/
ln -s /etc/letsencrypt/live/<domain>/privkey.pem ./data/

1.5、修改配置文件

sudo nano ./data/config.json

在其中添加或修改以下内容：

    "api_key": "",
    "index": "openlist"
  },
  "scheme": {
    "address": "0.0.0.0",
    "http_port": -1,
    "https_port": 45244,
    "force_https": true,
    "cert_file": "data/fullchain.pem",
    "key_file": "data/privkey.pem",
    "unix_file": "",
    "unix_file_perm": "",
    "enable_h2c": false,
    "enable_h3": false
  },
  "temp_dir": "data/temp",
  "bleve_dir": "data/bleve",
  "dist_dir": "",

重启服务

sudo systemctl restart openlist

暴露端口

sudo ufw allow 45244

然后就可以打开 https://localhost:45244 访问 Openlist 的 Web 页面

1.6、查看管理员账号

journalctl -u openlist | grep -E "username|password"

2、添加存储

打开 Openlist 的 Web 页面，进入 管理 > 存储

点击 添加，然后配置相关内容

<summary>这是我本人的常用配置</summary>

[!TIP] 所有 <.*> 请自行替换成个人实际内容

添加「本机存储」

驱动：本机存储
挂载路径：<target_path>
排序依据：名称
排序方式：升序
文件夹排序方式：文件夹置顶
根文件夹路径：<source_path>

添加「对象存储」

驱动：对象存储
挂载路径：<target_path>
缓存过期时间：1
排序依据：名称
排序方式：升序
文件夹排序方式：文件夹置顶
启用签名：开启
根文件夹路径：/
存储桶：<backup>
端点：<url>
访问密钥 ID：<ak>
访问密钥：<sk>
强制路径样式：开启
列出对象版本：V2

添加「OpenList」

驱动：OpenList
挂载路径：<target_path>
缓存过期时间：1
排序依据：名称
排序方式：升序
文件夹排序方式：文件夹置顶
根文件夹路径：/
链接：<url>
用户名：<username>
密码：<password>

</details>

3、修改样式

打开 Openlist 的 Web 页面，进入 管理 > 设置 > 全局

在 自定义内容 中可以修改样式

以下是我个人的常用样式，包括 txt 预览默认自动换行，Markdown 预览美化等

<script>
const observer = new MutationObserver((mutations) => {
    mutations.forEach(() => {
        const buttons = document.querySelectorAll('div.obj-box.hope-stack button.hope-select__trigger');
        if (buttons[0] && buttons[1]) {
            if (!buttons[0].classList.contains('global-first-listbox-btn')) {
                buttons[0].classList.add('global-first-listbox-btn');
            }
            if (!buttons[1].classList.contains('global-second-listbox-btn')) {
                buttons[1].classList.add('global-second-listbox-btn');
            }
        }
    });
});

observer.observe(document.body, {
    childList: true,
    subtree: true
});
</script>

<style>
.markdown-body pre code[class*="language-txt" i] {
    display: block !important;
    width: 100% !important;
    white-space: pre-wrap !important;
    overflow-wrap: break-word !important;
    word-break: break-all !important;
    line-height: 2 !important;
    font-family: 
        "Source Han Serif SC",
        "Noto Serif CJK SC",
        "Source Han Serif CN",
        "Noto Serif CJK",
        "source-han-serif-sc",
        serif !important; 
    font-size: 16px !important;
}

.markdown-body :is(h1,h2,h3,h4,h5,h6,p){
    padding-inline: var(--hope-space-2) !important;
}
.markdown-body blockquote{
    margin-inline: var(--hope-space-2) !important;
    padding: 0 0.25em !important;
}
.markdown-body>:first-child {
    margin-top: 10px !important;
}
.markdown-body>:last-child {
    margin-bottom: 10px !important;
}

.global-first-listbox-btn {
    width: calc(var(--hope-sizes-full) - var(--hope-sizes-32) - 5px) !important;
}
div:has(> .global-second-listbox-btn) {
    width: var(--hope-sizes-32) !important;
    opacity: 1 !important;
}
.global-second-listbox-btn {
    position: relative !important;
    top: -48px !important;
    border-color: var(--hope-colors-info5) !important;
}
</style>

Ubuntu 配置 Samba

Sun, 16 Nov 2025 00:00:00 GMT

前言

关于 NAS 文件的管理方式多种多样，而使用 Samba 作为广为流传的一种方式，虽然我个人认为它并不太好，但它无疑是极为方便、简单的。

1、安装 Samba

sudo apt update && sudo apt install -y samba

2、创建 Samba 用户

sudo smbpasswd -a root

2、修改配置文件

[!TIP] 所有 <name> 请自行替换成个人实际挂载名称
所有 <path> 请自行替换成个人实际目录
所有 <user> 请自行替换成个人实际用户名

sudo nano /etc/samba/smb.conf

在文件末尾添加以下内容：

[<name>]
path = <path>
browsable = yes
writable = yes
read only = no
guest ok = no
valid users = <user>

例如：

[root]
path = /root/
browsable = yes
writable = yes
read only = no
guest ok = no
valid users = root

[870evo]
path = /mnt/870evo/
browsable = yes
writable = yes
read only = no
guest ok = no
valid users = root

[sc001xt_1]
path = /mnt/sc001xt_1/
browsable = yes
writable = yes
read only = no
guest ok = no
valid users = root

[sc001xt_2]
path = /mnt/sc001xt_2/
browsable = yes
writable = yes
read only = no
guest ok = no
valid users = root

[micron1100]
path = /mnt/micron1100/
browsable = yes
writable = yes
read only = no
guest ok = no
valid users = root

4、重启 Samba

sudo systemctl restart smbd nmbd

暴露端口

sudo ufw allow Samba

5、Windows 连接到 Samba

首先进入 文件资源管理器

找到此电脑并右键，点击 映射网络驱动器

填入相应的信息，然后点击 完成

aria2 和 aria-ng 部署教程：多协议下载工具

Sun, 16 Nov 2025 00:00:00 GMT

前言

aria2 是一个多协议下载工具，aria-ng 是相应的 Web 管理工具。二者结合，就是一个管理方便，高效迅速的网页下载工具。我写的一些爬虫程序，也都会连接 aria2 去下载资源。

1、环境配置

[!TIP] nginx == *

如果你已经有了相应的环境，可以跳过该部分

1.1、安装 Nginx

# 安装并启动 Nginx
sudo apt update && sudo apt install -y nginx
sudo systemctl --now enable nginx

# 验证
nginx -v

# 删除默认配置
rm -rf /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default

2、部署 aria2

2.1、安装 aria2

sudo apt update && sudo apt install -y aria2

2.2、创建配置

[!TIP] 所有 <path> 请自行替换成个人实际目录
所有 <password> 请自行替换成个人实际密码

sudo mkdir -p <path>/aria/aria2/ && cd <path>/aria2/
touch ./aria2/aria2.conf
touch ./aria2/aria2.session
nano ./aria2/aria2.conf

在其中添加或修改以下内容：

# 下载目录
dir=<path>/aria2/Downloads

# 自动重命名
auto-file-renaming=true

# RPC 设置
enable-rpc=true
rpc-listen-all=true
rpc-allow-origin-all=true
rpc-secret=<password>

# 断点续传
input-file=<path>/aria/aria2/aria2.session
save-session=<path>/aria/aria2/aria2.session

# 并发和连接
max-concurrent-downloads=5
split=10
max-connection-per-server=10

# 忽略安全证书问题
check-certificate=false

# 设置重试请求
max-tries=10
retry-wait=30
auto-file-renaming=false
connect-timeout=60
timeout=60

# 日志
log=<path>/aria/aria2/aria2.log
log-level=warn

2.3、运行 aria2

sudo nano /etc/systemd/system/aria2.service

在其中添加或修改以下内容：

[Unit]
Description=Aria2c Download Manager
After=network.target

[Service]
User=root
ExecStart=/usr/bin/aria2c --conf-path=<path>/aria/aria2/aria2.conf
Restart=on-failure

[Install]
WantedBy=multi-user.target

暴露端口

sudo ufw allow 6800

启动服务

systemctl daemon-reload
sudo systemctl enable --now aria2

2.4、设置定时重启

sudo sh -c 'echo "0 3 * * * root /bin/systemctl restart aria2" >> /etc/crontab'

验证任务

grep aria2 /etc/crontab

3、部署 aria-ng

3.1、下载 aria-ng

前往 https://github.com/mayswind/AriaNg/releases 选择合适的版本

::github{repo="mayswind/AriaNg"}

然后下载相应的文件

wget -O ariang.zip <url>

例如：

wget -O ariang.zip https://github.com/mayswind/AriaNg/releases/download/1.3.11/AriaNg-1.3.11.zip

也可自行添加代理，例如：

http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118 \
  wget -O ariang.zip https://github.com/mayswind/AriaNg/releases/download/1.3.11/AriaNg-1.3.11.zip

解压文件

sudo unzip ariang.zip -d aria-ng && rm -rf ariang.zip
sudo chmod -R 777 aria-ng

3.2、配置 Nginx

配置 Nginx

sudo nano /etc/nginx/sites-available/aria-ng.conf

在其中添加以下几行：

server {
    listen 45245;
    listen [::]:45245;
    server_name _;

    root <path>/aria2/aria-ng/;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

链接 Nginx

sudo ln -s /etc/nginx/sites-available/aria-ng.conf /etc/nginx/sites-enabled/

暴露端口

sudo ufw allow 45245

重启 Nginx

sudo systemctl restart nginx

然后就可以打开 http://localhost:45245 访问 aria2-ng 的 Web 页面

3.3、连接 aria2

打开 aria2-ng 的 Web 页面，进入 AriaNG 设置

点击左上角加号

填入 aria2 相关信息，然后刷新页面就可以了

N100 在 Ubuntu 上安装核显驱动

Sat, 15 Nov 2025 00:00:00 GMT

前言

我目前的主力 NAS 是基于畅网 N100 开发板组装的，系统使用的是 Ubuntu 22.04.5 LTS。在这台 NAS 上需要用到核显的情况现在也就两个，一个是 Emby 的硬件解码，另一个就是 Immich 的 AI 识别，本文是对于我个人安装核显驱动的记录。

1、准备环境

sudo apt update && sudo apt install -y gpg-agent wget

2、添加 Intel 软件源

. /etc/os-release
if [[ ! " jammy " =~ " ${VERSION_CODENAME} " ]]; then
  echo "Ubuntu version ${VERSION_CODENAME} not supported"
else
  wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | \
    sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg
  echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu ${VERSION_CODENAME}/lts/2350 unified" | \
    sudo tee /etc/apt/sources.list.d/intel-gpu-${VERSION_CODENAME}.list
  sudo apt update
fi

3、安装核心驱动

sudo apt install -y \
  linux-headers-$(uname -r) \
  linux-modules-extra-$(uname -r) \
  flex bison \
  intel-fw-gpu intel-i915-dkms xpu-smi

重启系统

sudo reboot

4、安装计算和媒体中心

sudo apt install -y \
  intel-opencl-icd intel-level-zero-gpu level-zero \
  intel-media-va-driver-non-free libmfx1 libmfxgen1 libvpl2 \
  libigdgmm12 vainfo hwinfo clinfo intel-gpu-tools

5、验证安装

# 验证 i915 驱动
hwinfo --display

# 查看 GPU 硬件信息
sudo xpu-smi discovery -d 0

# 查看 GPU 使用情况
intel_gpu_top

参考文献

Ubuntu 22 安装 Intel N100 显卡驱动

自建代理节点：Xray、Shadowsocks

Sat, 15 Nov 2025 00:00:00 GMT

前言

事先声明，本人对于网络技术的了解还比较薄弱，本文也只是写了如何搭建代理节点，但代理是什么，以及节点如何使用，我一概不知，也没有这方面的兴趣和精力去了解。

言归正传，如果想要自建代理节点，首先得有一台云服务器，大部分 IDC 的云服务器对于 Xray、Shadowsocks 这一类的工具都有自动检查，不建议在明确不支持自建代理节点的 IDC 的云服务器上去这么做，如果你的 IDC 不支持自建代理节点，那我只能建议你去使用 socks 连接了，只不过这样子速度会慢很多。

支持自建代理节点的 IDC 也有挺多的，但我对这一方面的了解不多，如果你有好用的 IDC 推荐，也可以告诉我，让我贴在文章结尾。

1、Xray

1.1、安装 Xray

sudo bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install

1.2、启动 Xray

[!TIP] 所有 <port> 请自行替换成个人实际选择的端口
所有 <uuid> 请自行替换成个人实际生成的 uuid

首先要生成 uuid 作为连接密钥

uuidgen

编辑配置文件

sudo nano /usr/local/etc/xray/config.json

在其中添加或修改以下内容：

{
  "inbounds": [{
    "port": <port>,
    "protocol": "vmess",
    "settings": {
      "clients": [{
        "id": "<uuid>",
        "alterId": 0
      }]
    },
    "streamSettings": {
      "network": "ws",
      "security": "none"
    }
  }],
  "outbounds": [{"protocol": "freedom"}]
}

启动服务

sudo systemctl enable --now xray

暴露端口

sudo ufw allow <port>

1.3、编写 Clash 配置文件的节点

不同内核的节点格式是不同的，请自行查看相关信息并修改。

<summary>这是 Meta / Mihomo 内核的节点格式</summary>

具体配置请前往 https://wiki.metacubex.one/config/proxies 查看文档

[!TIP] 所有 <name> 请自行替换成个人实际选择的节点名称
所有 <ip> 请自行替换成个人实际的服务器 ip

proxies:
  - name: "<name>"
    type: vmess
    server: <ip>
    port: <port>
    uuid: "<uuid>"
    alterId: 0
    cipher: auto
    network: ws
    tls: false

</details>

1.4、删除 Xray

sudo apt purge xray && sudo apt autoremove

2、Shadowsocks

2.1、安装 Shadowsocks

sudo apt install -y shadowsocks-libev

2.2、启动 Shadowsocks

[!TIP] 所有 <port> 请自行替换成个人实际选择的端口
所有 <password> 请自行替换成个人实际选择的密码

编辑配置文件

sudo nano /etc/shadowsocks-libev/config.json

在其中添加或修改以下内容：

{
    "server": "0.0.0.0",
    "server_port": <port>,
    "password": "<password>",
    "method": "chacha20-ietf-poly1305",
    "timeout": 60,
    "fast_open": true,
    "mode": "tcp_and_udp"
}

启动服务

sudo systemctl enable --now shadowsocks-libev

暴露端口

sudo ufw allow <port>

2.3、编写 Clash 配置文件的节点

不同内核的节点格式是不同的，请自行查看相关信息并修改。

<summary>这是 Meta / Mihomo 内核的节点格式</summary>

具体配置请前往 https://wiki.metacubex.one/config/proxies 查看文档

[!TIP] 所有 <name> 请自行替换成个人实际选择的节点名称
所有 <ip> 请自行替换成个人实际的服务器 ip

proxies:
  - name: "<name>"
    type: ss
    server: <ip>
    port: <port>
    cipher: chacha20-ietf-poly1305
    password: "<password>"
    udp: true

</details>

2.4、删除 Shadowsocks

sudo apt purge shadowsocks-libev && sudo apt autoremove

qBittorrent 部署教程：p2p 下载工具

Sat, 15 Nov 2025 00:00:00 GMT

前言

人人为我，我为人人，这就是 p2p ( Peer-to-Peer ) 技术诞生的根本。作为不完全依赖服务端的，去中心化的文件分享技术，它可以有效地摆脱第三方监控，让人们在互联网上随心所欲地分享资源。

qBittorrent 就是众多 p2p 下载工具中较为出众的一个，本文会简略地写出 qBittorrent 的部署步骤和优化方式，以及在结尾贴出一些常用的资源站点。

1、环境配置

[!TIP] Docker == *

如果你已经有了相应的环境，则可以跳过该部分

1.1、安装 Docker

具体安装方法可以查看 Docker 教程的说明

2、部署 qBittorrent

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/qbittorrent/config/ && cd <path>/qbittorrent/

2.2、编写 docker-compose 配置文件

[!TIP] 所有 <downloads_path> 请自行替换成个人实际下载保存路径

sudo nano docker-compose.yml

在其中添加或修改以下内容：

services:
  qbittorrent:
    image: linuxserver/qbittorrent:latest
    container_name: qbittorrent
    ports:
      - 48081:48081
      - 46881:46881
    environment:
      - WEBUI_PORT=48081
      - TORRENTING_PORT=46881
      - PUID=0
      - PGID=0
      - UMASK=000
    volumes:
      - ./config:/config
      - <downloads_path>:<downloads_path>
    restart: unless-stopped

2.3、启动 qBittorrent

docker compose up -d

暴露端口

sudo ufw allow 48081
sudo ufw allow 46881

然后就可以打开 http://localhost:48081 访问 qBittorrent 的 Web 页面

[!NOTE] 默认用户名：admin

2.4、查看密码

docker logs qbittorrent 2>&1 | grep -E "password"

2.5、关闭 qBittorrent

docker compose down

3、通用配置

3.1、开启 UPnP

打开 qBittorrent 的 Web 页面，进入 设置 > 连接，开启 UPnP

3.2、关闭 Torrent 排队

打开 qBittorrent 的 Web 页面，进入 设置 > BitTorrent，关闭 Torrent 排队

4、BT 配置

[!TIP] BT ( BitTorrent ) 是一种公开的、去中心化的文件共享协议，p2p 中的代表，所有人都可以自由加入和下载。它可以将文件分片存储于多个参与者的设备中，让每个人既可以是下载者，也可以是分享者。

4.1、配置热门 Tracker

BT 下载速度来源于其他用户的上传速度，而 Tracker 就是 BT 下载中相当重要的一个角色，它可以帮助你连接更多的用户，提升整体下载速度，提前配置一些热门的 Tracker，可以很好地提升你的 p2p 体验。

这是一个热门 Tracker 的整合项目

::github{repo="XIU2/TrackersListCollection"}

我们需要在这个项目里选择一个合适的 Tracker 列表，如：https://cf.trackerslist.com/best.txt

然后打开 qBittorrent 的 Web 页面，进入 设置 > BitTorrent，填入 URl 并开启自动更新

如果无法成功获取，大概率是 CF 问题，可以先跳到下面的获取优选 IP 看看

过多的 Tracker 会引起大量的网络请求，如 DNS 查询、建立连接、发送请求和解析响应，所以我建议将「总是向所有等级的 Tracker 汇报」关闭。

打开 qBittorrent 的 Web 页面，进入 设置 > 高级，关闭这个选项

4.2、做种限制

现如今的 BT 环境并不太好，特别是之前还有玩 PCDN 的拿 BT 资源无限刷下载率。BT 不像 PT 那样有严格的审查，所以我还是建议做一些自行限制的，比如限制分享率为 1~2，做到有拿有还就好。

打开 qBittorrent 的 Web 页面，进入 设置 > BitTorrent，自行修改做种限制

5、PT 配置

[!TIP] PT ( Private Tracker ) 是建立在 BT 技术之上的私有社区，大部分必须通过邀请码注册才能进入，对下载和上传有一定限制和要求。

5.1、使用 CloudflareST 自选 IP 解决 Tracker 连接问题

PT 本身就是小众的东西，一些小的站点更是脆弱无比，所以这些站点基本都会套上 CF，由于 CF 没有在国内架设免费节点且因国内网络特殊性可能导致 qBittorrent 下载、做种时出现 Tracker 未工作或待机的情况，这时候就需要设置优选 IP 来保证连接。

* 5.1.1、获取优选 IP

创建目录

mkdir -p <path>/cfst/ && cd <path>/cfst/

下载 CloudflareST

请先前往 https://github.com/XIU2/CloudflareSpeedTest/releases 选择适合的版本

::github{repo="XIU2/CloudflareSpeedTest"}

然后下载相应的文件

wget -O cfst.tar.gz <url>

例如：

wget -O cfst.tar.gz https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.4/cfst_linux_amd64.tar.gz

也可自行添加代理，例如：

http_proxy=http://127.0.0.1:8118 https_proxy=http://127.0.0.1:8118 \
  wget -O cfst.tar.gz https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.4/cfst_linux_amd64.tar.gz

解压文件

tar -zxvf cfst.tar.gz --one-top-level=cfst --strip-components=1 && rm -rf cfst.tar.gz

设置运行权限

chmod +x cfst

获取优选 IP

./cfst -dd

然后就可以自行挑选一个合适的优选 IP

* 5.1.2、设置优选 IP

返回 qBittorrent 目录

cd <path>/qbittorrent/

编写 docker-compose 配置文件

sudo nano docker-compose.yml

在其中添加或修改以下内容：

[!TIP] <domain> 请自行替换成目标 PT 站点的 Tracker 地址
<ip> 请自行替换成个人选择的优选 IP

services:
  qbittorrent:
    image: linuxserver/qbittorrent:latest
    container_name: qbittorrent
    ports:
      - 48081:48081
      - 46881:46881
    environment:
      - WEBUI_PORT=48081
      - PEER_PORT=46881
      - PUID=0
      - PGID=0
      - UMASK=000
    volumes:
      - <path>/qbittorrent:/config
      - <downloads_path>:<downloads_mount>
    extra_hosts:
      - <domain>:<ip>
    restart: unless-stopped

重新启动 qBittorrent

docker compose down && docker compose up -d

5.2、限制下载速度

相比于 BT 而言，PT 的大部分资源下载速度都很快。这是好事，但太快了也不好，特别是对一些性能较弱的小主机，很难带动长时间的高速下载。这时候，就需要对下载速度进行一定的限制。

打开 qBittorrent 的 Web 页面，进入 设置 > 速度，自行修改全局速度限制

5.3、预分配磁盘空间

打开 qBittorrent 的 Web 页面，进入 设置 > 下载，开启预分配磁盘空间

5.4、关闭 DHT / PEX / LSD

打开 qBittorrent 的 Web 页面，进入 设置 > BitTorrent，关闭 DHT / PEX / LSD

5.5、取消连接限制

打开 qBittorrent 的 Web 页面，进入 设置 > 连接，取消连接限制

常用站点

OpenWRT 配置 AdGuardHome

Fri, 14 Nov 2025 00:00:00 GMT

前言

AdGuardHome 是 OpenWRT 上的一个免费开源，功能强大的自建 DNS 服务器工具，本文是对于我个人常用设置的记录。

1、安装 AdGuaedHome

打开 OpenWRT 的 Web 页面

进入 系统 > 软件包
搜索并安装 luci-app-adguardhome
或者手动上传安装包

2、安装核心

打开 OpenWRT 的 Web 页面

进入 服务 > AdGuardHome 点击更新核心版本

也可自行下载并上传核心，替换 /usr/bin/AdGuardHome/AdGuardHome 文件

然后给予该文件执行权限

chmod 755 /usr/bin/AdGuardHome/AdGuardHome

3、初始配置

打开 OpenWRT 的 Web 页面

进入 服务 > AdGuardHome

点击网页管理端口下面的按钮，即可打开 AdGuaedHome 的 Web 页面

第一次应该是网页管理界面，需要配置相关内容

网页管理界面端口：3000
DNS 服务器端口：5353

4、DNS 设置

打开 AdGuaedHome 的 Web 页面

进入 设置 > DNS 设置 > 上游 DNS 服务器

填入多个 DNS 服务器，换行区分

5、设置定时重启

打开 OpenWRT 的 Web 页面

进入 系统 > 计划任务

在其中添加：0 3 * * * /etc/init.d/AdGuardHome restart

6、修复开机不自动启动

/etc/init.d/AdGuardHome disable
/etc/init.d/AdGuardHome enable
reboot

OpenWRT 配置 Nikki

Fri, 14 Nov 2025 00:00:00 GMT

前言

Nikki 是 OpenWRT 上的一个网络代理工具，功能精简专一，本文是对于我个人常用设置的记录。

1、全局配置

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 混入配置 > 全局配置

配置相关内容

IPv6：启用
统一延迟：启用
TCP 并发：启用
禁用 TCP Keep Alive：启用
TCP Keep Alive 空闲：600
TCP Keep Alive 间隔：15

2、外部控制

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 混入配置 > 外部控制

配置相关内容

保存节点/策略组选择：勾选

勾选自己想使用的面板，并修改 API 密钥

3、TUN 配置

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 混入配置 > TUN 配置

配置相关内容

栈：Mixed

4、GeoX 配置

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 混入配置 > GeoX 配置

配置相关内容

GeoIP 格式：MMDB
GeoData 加载器：标准加载器
定时更新 GeoX 文件：勾选
GeoX 文件更新间隔：72

如果需要自定义数据库下载地址，可以前往 https://github.com/MetaCubeX/meta-rules-dat 选择合适的数据库

::github{repo="MetaCubeX/meta-rules-dat"}

也可自行下载并上传 GeoX 文件，放入 /etc/nikki/run/ 文件夹

然后给予这些文件执行权限

chmod 755 /etc/nikki/run/GeoSite.dat
chmod 755 /etc/nikki/run/geoip.metadb

5、DNS 配置

打开 OpenWRT 的 Web 页面

进入 网络 > DHCP/DNS > 常规

配置相关内容

DNS 重定向：不勾选

进入 服务 > Nikki > 混入配置 > DNS 配置

配置相关内容

DNS 模式：Fake-IP

6、嗅探器配置

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 混入配置 > 嗅探器配置

配置相关内容

启用：勾选

7、代理配置

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 代理配置 > 代理配置

配置相关内容

IPv4 DNS 劫持：勾选
IPv6 DNS 劫持：勾选

进入 服务 > Nikki > 代理配置 > 路由器代理

配置相关内容

启用：不勾选

8、插件配置

打开 OpenWRT 的 Web 页面

进入 服务 > Nikki > 插件配置

配置相关内容

启用：勾选
启动延迟：60
定时重启：勾选
Cron 表达式：0 4 * * *

上传自己的配置文件并选择

也可自行下载并上传 Meta 核心，替换 /usr/bin/mihomo 文件

然后给予该文件执行权限

chmod 755 /usr/bin/mihomo

最后重新启动 Nikki

9、设置定时重启

打开 OpenWRT 的 Web 页面

进入 系统 > 计划任务

在其中添加：0 3 * * * /etc/init.d/nikki restart

OpenWRT 配置 OpenClash

Fri, 14 Nov 2025 00:00:00 GMT

前言

OpenClash 是 OpenWRT 上的一个网络代理工具，功能强大多样，本文是对于我个人常用设置的记录。

1、安装插件

进入 系统 > 软件包

搜索并安装 openclash 和 ipset
或者手动上传安装包

然后下载相关依赖

opkg update
opkg install bash iptables dnsmasq-full curl ca-bundle ipset ip-full \
  iptables-mod-tproxy iptables-mod-extra ruby ruby-yaml kmod-tun \
  kmod-inet-diag unzip luci-compat luci luci-base

2、配置内核

进入 服务 > OpenClash > 插件设置 > 版本更新

找到 Meta 内核进行下载

进入 服务 > OpenClash > 配置管理

配置相关内容

上传文件类型：内核文件

之后选择 Meta 内核文件进行上传

3、设置运行模式

进入 服务 > OpenClash > 插件设置 > 模式设置

配置相关内容

运行模式：Fake-IP (TUN-混合) 模式
网络栈协议：Mixed
代理模式：Rule
延迟启动（秒）：60

4、设置 DNS

进入 网络 > DHCP/DNS > 限制

配置相关内容

DNS 查询缓存的大小：0

进入 服务 > OpenClash > 插件设置 > DNS 设置

配置相关内容

本地 DNS 劫持：使用防火墙转发

进入 服务 > OpenClash > 覆写设置 > DNS 设置

配置相关内容

自定义上游 DNS 服务器：启用
Fake-IP 持久化：启用
Fake-IP-Fitter：启用

设置自定义上游 DNS 服务器

NameServer：自行勾选
FallBack：自行勾选

5、设置数据库

进入 服务 > OpenClash > 插件设置 > GEO 数据库订阅

配置相关内容

自动更新 GeoIP MMDB 数据库：启用
自动更新 GeoSite 数据库：启用

自行选择更新模式

保存后点击 检查并更新

6、Meta 设置

进入 服务 > OpenClash > 覆写设置 > Meta 设置

配置相关内容

启用 TCP 并发：启用
启用统一延迟：启用
Geodata 数据加载方式：标准模式

7、自定义规则

进入 服务 > OpenClash > 覆写设置 > 规则设置

配置相关内容

自定义规则：启用

具体配置请前往 https://wiki.metacubex.one/config/rules 查看

开启后可自定义规则，例如想让局域网某个设备只走直连，可以使用：

- SRC-IP-CIDR,<ip>/32,DIRECT

8、处理 IPv6

进入 服务 > OpenClash > 插件设置 > IPv6 设置

配置相关内容

允许 IPv6 类型 DNS 解析：启用

9、黑白名单

进入 服务 > OpenClash > 插件设置 > 黑白名单

配置相关内容

局域网访问控制模式：黑名单模式

自行选择不走代理的局域网设备

10、定时重启

进入 服务 > OpenClash > 插件设置 > 定时重启

配置相关内容

定时重启：启用
重启时间(每周)：每天
重启时间(每天)：5:00

11、上传订阅信息

进入 服务 > OpenClash > 配置订阅

添加订阅信息，填入机场名称和订阅地址，然后配置相关内容

自动更新：启用

最后自行选择更新模式

或者进入 服务 > OpenClash > 配置管理

配置相关内容

上传文件类型：配置文件

最后选择配置文件进行上传

OpenWRT 基础配置

Thu, 13 Nov 2025 00:00:00 GMT

前言

之前折腾软路由的时候，我的 N5105 天天崩溃，所以我曾一天装了好几次 OpenWRT，以及不同分支的不同版本。每次装完，都需要凭记忆去重新配置一遍，虽然最后排查出来是我廉价内存条的问题，但还是想写下这篇备忘录，以备不时之需。

不过由于各分支不同版本之间存在差异，所以部分配置的选项所处的位置，名称都可能有所不同，需自行修改适应，本文以 ImmortalWRT 为主，且默认为主路由拨号上网，不考虑旁路由的情况。

1、接口设置

1.1、WAN 配置

[!TIP] 所有 <username> 请自行替换成个人实际用户名
所有 <password> 请自行替换成个人实际密码

打开 OpenWRT 的 Web 页面

进入 网络 > 接口，配置相关内容

网络 > 接口 > wan > 编辑 > 常规设置
协议：PPPoE
设备：eth0
PAP/CHAP 用户名：<username>
PAP/CHAP 密码：<password>

网络 > 接口 > wan > 编辑 > 高级设置
LCP 响应故障阈值：10
LCP 响应间隔：5

网络 > 接口 > wan > 编辑 > 防火墙设置
创建/分配防火墙区域：wan

1.2、LAN 配置

打开 OpenWRT 的 Web 页面

进入 网络 > 接口，配置相关内容

网络 > 接口 > lan > 编辑 > 高级设置
IPv6 分配长度：64

网络 > 接口 > lan > 编辑 > 防火墙设置
创建/分配防火墙区域：lan

网络 > 接口 > lan > 编辑 > DHCP 服务器 > IPv6 设置
RA 服务：服务器模式
DHCPv6 服务：服务器模式
NDP 代理：已禁用

网络 > 接口 > lan > 编辑 > DHCP 服务器 > IPv6 RA 设置
默认路由器：自动
启用 SLAAC：启用
RA 标记：受管配置、其它配置

网络 > 接口 > 设备 > br-lan > 配置
网桥端口：勾选除了 eth0 以外的端口

2、防火墙设置

打开 OpenWRT 的 Web 页面

进入 网络 > 防火墙 > 常规设置 > 常规设置

配置相关内容

入站数据：接受
出站数据：接受
转发：接受

进入 网络 > 防火墙 > 常规设置 > 区域 > lan => wan > 编辑

配置相关内容

入站数据：接受
出站数据：接受
转发：接受

3、扩容

3.1、找到系统磁盘

fdisk -l

在其中找到提供扩容的硬盘

[!TIP] 后续的 <sdX> 请自行替换成提供扩容的硬盘

3.2、创建新分区

fdisk /dev/<sdX>

输入 p 打印当前分区表
输入 n 创建新分区
输入 w 保存并退出

然后重新查看系统磁盘分区

fdisk -l

在其中找到新创建的分区

[!TIP] 后续的 <sdXd> 请自行替换成新创建的分区

3.3、格式化新分区

mkfs.ext4 /dev/<sdXd>

3.4、挂载新分区

打开 OpenWRT 的 Web 页面

进入 openwrt > 系统 > 挂载点 > 添加

配置相关内容

UUID：根据大小判断新创建的分区
挂载点：作为根文件系统使用

3.5、根目录准备

mkdir -p /tmp/introot
mkdir -p /tmp/extroot
mount --bind / /tmp/introot
mount /dev/<sdXd> /tmp/extroot
tar -C /tmp/introot -cvf - . | tar -C /tmp/extroot -xf -
umount /tmp/introot
umount /tmp/extroot

3.6、重启软路由

reboot

常用 OpenWRT 软件

名称	<span style="white-space: nowrap;">类型</span>	所需软件包
adguardhome	自建 DNS	`luci-app-adguardhome`
argon	主题	`luci-theme-argon`, `luci-app-argon-config`, `luci-i18n-argon-config-zh-cn`
ddns-go	动态 DNS	`ddns-go`, `luci-app-ddns-go`, `luci-i18n-ddns-go-zh-cn`
lucky	网络工具	`lucky`, `luci-app-lucky`, `luci-i18n-lucky-zh-cn`
nikki	代理工具	`nikki`, `luci-app-nikki`, `luci-i18n-nikki-zh-cn`
openclash	代理工具	`luci-app-openclash`

Docker 教程

Wed, 12 Nov 2025 00:00:00 GMT

前言

Docker 是一种轻量级容器技术，可将应用及其依赖打包成标准化单元。它能实现跨平台一致运行，极大简化了开发、测试和部署流程。

1、安装 Docker

# 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 更新 apt 包索引
sudo apt-get update

# 安装 apt 依赖包
sudo apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

# 添加 Docker 的官方 GPG 密钥
curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

# 使用以下指令设置稳定版仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/ \
 $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 更新 apt 包索引
sudo apt-get update

# 安装最新版本的 Docker Engine-Community 和 containerd
sudo apt-get install -y docker-ce docker-ce-cli containerd.io

2、基础命令

2.1、下载镜像

docker pull [选项] <镜像名>[:标签]

[!NOTE] 选项：
-a 下载镜像的所有标签版本
-q 安静模式，不输出详细信息

示例：

# 下载最新版 Ubuntu 镜像
docker pull ubuntu

# 下载指定标签的 Nginx 镜像 (版本为 1.25.3)
docker pull nginx:1.25.3

2.2、查看信息

docker images

示例：

# 过滤查看 nginx 相关信息
docker images | grep nginx

2.3、删除镜像

# 删除指定镜像
docker rmi <镜像ID/镜像名:标签>

# 删除所有悬空镜像 (未被任何镜像引用的层)
docker image prune

# 删除所有未被容器使用的镜像
docker image prune -a

示例：

# 删除指定标签的镜像
docker rmi nginx:1.25.3

# 通过镜像ID前几位删除
docker rmi d23adb...

2.4、查看容器

# 查看运行中的容器
docker ps

# 查看所有容器（包括已停止的）
docker ps -a

# 获取所有容器的 ID
docker ps -aq

2.5、停止或删除容器

# 停止运行中的容器
docker stop <容器ID/容器名>

# 删除已停止的容器
docker rm <容器ID/容器名>

# 强制删除运行中的容器
docker rm -f <容器ID/容器名>

2.6、查看卷

docker volume ls

2.7、删除卷

# 删除指定卷
docker volume rm <卷名>

# 删除所有未被容器使用的卷
docker volume prune

2.8、其他常用基础命令

运行容器

docker run [选项] <镜像名>

[!NOTE] 选项：
-d 后台运行
-p <主机端口>:<容器端口> 端口映射
-v <主机路径>:<容器路径> 数据卷挂载
--name <容器名称> 为容器指定一个名称

进入运行中的容器

# 使用/bin/bash
docker exec -it <容器ID> /bin/bash

# 使用/bin/sh
docker exec -it <容器ID> /bin/sh

查看容器资源使用

docker stats

查看镜像或容器的详细信息

docker inspect <镜像ID/容器ID>

3、Docker-Compose

请确保当前目录包含 docker-compose.yml 或 Dockerfile 之类的

docker compose up -d 构建并后台启动所有服务。
docker compose stop 停止正在运行的服务，可以通过 docker-compose start 再次启动。
docker compose start 启动已停止的服务。
docker compose down 停止项目并移除容器、网络、卷、镜像。
docker compose ps 列出项目中目前的所有容器。
docker compose logs -f 查看实时日志。
docker compose build 构建（重新构建）项目中的服务容器。
docker compose pull 拉取服务依赖的镜像。
docker compose restart 用于重新启动项目中的服务容器
docker compose rm 删除所有（停止状态的）服务容器。
docker compose create 用于创建在 Docker Compose 文件中定义的服务的容器，但不会启动这些容器。它主要用于预先创建容器，以便稍后通过 docker compose start 或 docker compose up 命令启动这些容器。

4、配置镜像站

4.1、创建配置文件

sudo mkdir -p /etc/docker/daemon.json

4.2、添加镜像站

先寻找合适的镜像站

::github{repo="dongyubin/DockerHub"}

打开配置文件

sudo nano /etc/docker/daemon.json

在其中添加或修改以下内容：

[!TIP] registry-mirrors 列表内的站点请自行替换成合适的站点

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xpg666.xyz"
  ]
}

4.3、重启 Docker 并验证

# 重启 Docker
sudo systemctl restart docker

# 验证
docker info | grep -i "registry mirrors" -A 6

5、配置代理

5.1、创建配置文件

sudo mkdir -p /etc/systemd/system/docker.service.d

5.2、添加代理

sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf

在其中添加或修改以下内容：

[!TIP] <ip> 请自行替换成个人实际代理地址

[Service]
Environment="HTTP_PROXY=<ip>"
Environment="HTTPS_PROXY=<ip>"
Environment="NO_PROXY=localhost,127.0.0.1"

5.3、重启 Docker 并验证

# 重启 Docker
sudo systemctl daemon-reload
sudo systemctl restart docker

# 验证
sudo systemctl show --property=Environment docker

参考文档

Linux 命令备忘录

Wed, 12 Nov 2025 00:00:00 GMT

前言

我曾经在知乎刷到过一个问题，是探讨如何才算真正掌握 Linux 的，底下的回答各有不同。其中有一个回答说他先前面试的公司，是通过让人默写十个 Linux 命令来评判的。这种评判标准肯定是不够好的，但也令我有感写下这篇备忘录。

由于我个人是长期的 Ubuntu 用户，所以这篇备忘录的内容以 Ubuntu 为主。

1、cd 说明

cd [目标路径]

示例：

# 进入用户主目录
cd ~
cd

# 返回上一级目录
cd ..

# 进入根目录
cd /

# 返回之前所在的目录
cd -

# 使用绝对路径
cd /usr/local/bin

# 使用相对路径
cd ./folder/

2、ls 说明

ls <选项> [目标路径]

[!NOTE] 选项：
-l 详细列表显示
-a 显示所有文件（包括隐藏文件）
-h 显示人类可读的文件大小
-t 按修改时间排序
-r 反向排序
-R 递归显示子目录

示例：

# 列出 /root/ 的文件
ls /root/

# 详细列出 /root/ 的所有文件
ls -la /root/

# 按时间排序显示 /root/ 的文件
ls -lt /root/

# 以人类可读的形式显示 /root/ 的文件大小
ls -lh /root/

# 递归列出 /root/ 的子目录
ls -R /root/

3、mkdir 说明

mkdir <选项> [目标路径]

[!NOTE] 选项：
-p 递归创建目录
-v 显示创建过程

示例：

# 创建单个目录
mkdir ./new_folder/

# 递归创建多级目录
mkdir -p /path/to/folder/

# 创建多个目录
mkdir dir1 dir2 dir3

# 显示创建过程
mkdir -pv ./project/{src,bin,doc}

4、rm 说明

rm <选项> [目标路径]

[!NOTE] 选项：
-r 或 -R 递归删除
-f 强制删除，不提示
-i 交互式删除，删除前确认
-v 显示删除过程

示例：

# 删除文件
rm file.txt

# 交互式删除
rm -i file.txt

# 递归删除目录
rm -r /path/to/folder/

# 强制递归删除
rm -rf /path/to/folder/

[!WARNING] rm -rf / 或 rm -rf /* 会删除系统所有文件，切勿尝试

5、chown 说明

chown <选项> [用户]<:用户组> [目标路径]

[!NOTE] 选项：
-c 或 --changes 仅在发生更改时显示详细输出
-f 或 --silent 静默模式，抑制大多数错误消息
-v 或 --verbose 显示每个文件的处理过程
-R 或 --recursive 递归更改文件和目录
--reference=RFILE 使用参考文件的模式而不是指定值

示例：

# 将文件所有者改为 user1
chown user1 file.txt

# 递归修改目录及其内容的所有者
chown -R user1 /path/to/folder/

# 同时修改所有者和用户组
chown user1:group1 file.txt

# 只修改用户组
chown :group1 file.txt

# 修改所有者并保持组不变
chown user1: file.txt

# 修改符号链接指向文件的所有者
chown -h user1 symlink

6、chmod 说明

chmod <选项> [权限模式] [目标路径]

[!NOTE] 选项：
-c 或 --changes 仅在发生更改时显示详细输出
-f 或 --silent 静默模式，抑制大多数错误消息
-v 或 --verbose 显示每个文件的处理过程
-R 或 --recursive 递归更改文件和目录
--reference=RFILE 使用参考文件的模式而不是指定值
--from=[用户]<:用户组> 仅当当前所有者和组匹配时才更改

示例：

# 数字模式设置权限
chmod 755 file.sh          # rwxr-xr-x
chmod 644 file.txt         # rw-r--r--
chmod 600 private.key      # rw-------

# 符号模式设置权限
chmod u+x script.sh        # 给所有者添加执行权限
chmod g-w file.txt         # 移除所属组的写权限
chmod o=r file.txt         # 设置其他用户只有读权限
chmod a+w logfile.log      # 所有用户添加写权限

# 递归修改目录权限
chmod -R 755 /var/www/html

# 同时设置多种权限
chmod u=rw,g=r,o= file.txt # 所有者读写，所属组读，其他用户无权限

# 复制其他用户的权限
chmod g=u file.txt         # 让组权限与所有者权限相同

7、find 说明

find [目标] [选项] [操作]

[!NOTE] 选项：
-name：按文件名查找
-type：按文件类型查找（f=文件，d=目录）
-size：按文件大小查找
-mtime：按修改时间查找
-exec：对找到的文件执行命令

示例：

# 在当前目录查找 *.txt 文件
find . -name "*.txt"

# 按文件类型查找
find /home -type f -name "*.conf"
find /var -type d -name "log*"

# 按大小查找
find / -size +100M    # 大于 100MB 的文件
find . -size -10k     # 小于 10KB 的文件

# 按时间查找
find . -mtime -7      # 7 天内修改的文件
find . -mtime +30     # 30 天前修改的文件

# 查找并删除
find /tmp -name "*.tmp" -delete
find . -name "*.log" -exec rm {} \;

# 查找并显示详细信息
find . -name "*.sh" -exec ls -l {} \;

8、du 说明

du <选项> [目标路径]

[!NOTE] 选项：
-h：显示人类可读的格式
-s：只显示总大小
-a：显示所有文件大小
--max-depth=N：显示指定深度的目录

示例：

# 显示当前目录大小
du -sh

# 显示 /var/log/ 的文件详细大小
du -h /var/log/

# 显示 /var/log/ 指定深度的文件详细大小
du -h --max-depth=1 /var/log/

# 按大小排序显示 /var/log/ 的文件
du -h /var/log/ | sort -hr

# 查找 /var/log/ 的大文件
du -ah /var/log/ | sort -rh | head -20

9、lsof 说明

lsof <选项> [文件名或进程名]

[!NOTE] 选项：
-i 显示网络连接
-p 指定进程 ID
-c 指定进程名
-u 指定用户
+D 递归显示目录下被打开的文件
-n 不解析主机名
-P 不解析端口名

示例：

# 显示所有打开的文件
lsof

# 显示指定用户打开的文件
lsof -u root

# 显示网络连接
lsof -i

# 显示指定端口的连接
lsof -i :80

# 显示指定进程打开的文件
lsof -p 1234

# 显示指定命令打开的文件
lsof -c nginx

# 显示目录下被打开的文件
lsof +D /var/log/

# 显示 TCP 连接
lsof -i tcp

# 显示 UDP 连接  
lsof -i udp

# 显示指定用户和网络连接
lsof -u www-data -i

# 恢复被删除但仍在使用的文件
lsof | grep deleted

10、curl 说明

curl <选项> [URL]

[!NOTE] 选项：
-o 将输出保存到指定文件
-O 使用远程文件名保存到当前目录
-L 跟随重定向
-H 添加 HTTP 请求头
-X 指定请求方法（GET/POST等）
-d 发送 POST 数据
-F 发送表单数据
-u 设置认证信息
-A 设置 User-Agent
-x 使用代理
-I 只获取响应头
-s 静默模式
-v 详细输出
--limit-rate 限制传输速率
-C - 断点续传

示例：

# 下载文件
curl -O https://example.com/file.zip
curl -o custom_name.zip https://example.com/file.zip

# 跟随重定向并保存
curl -L -o page.html https://example.com

# 发送POST请求
curl -X POST -d "name=value" https://api.example.com/submit
curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/data

# 使用认证
curl -u username:password https://api.example.com/protected

# 上传文件
curl -F "file=@localfile.txt" https://example.com/upload

# 只查看头部信息
curl -I https://example.com

# 限制下载速度
curl --limit-rate 1M -O https://example.com/largefile.iso

# 断点续传
curl -C - -O https://example.com/largefile.zip

11、wget 说明

wget <选项> [URL]

[!NOTE] 选项：
-O 指定输出文件名
-P 指定下载目录
-c 断点续传
-r 递归下载
-np 不追溯到父目录
-l 设置递归深度
-k 转换链接为本地链接
-p 下载页面所需所有资源
-q 静默模式
-v 详细输出
--limit-rate 限制下载速度
-b 后台下载
-i 从文件读取 URL 列表
-U 设置 User-Agent
--header 添加 HTTP 头

示例：

# 下载单个文件
wget https://example.com/file.zip

# 指定保存文件名和目录
wget -O custom_name.zip -P /home/user/downloads https://example.com/file.zip

# 断点续传
wget -c https://example.com/largefile.iso

# 递归下载整个网站
wget -r -l 5 -k -p https://example.com

# 限制下载速度
wget --limit-rate=500k https://example.com/largefile.zip

# 后台下载
wget -b https://example.com/largefile.zip

# 从文件读取URL列表下载
wget -i url_list.txt

# 设置 User-Agent
wget -U "Mozilla/5.0" https://example.com

# 添加请求头
wget --header="Authorization: Bearer token" https://api.example.com/data

12、ufw

12.1、查看 ufw 状态

sudo ufw status

12.2、开启/关闭防火墙

# 开启防火墙
sudo ufw enable
# 关闭防火墙
sudo ufw disable

12.3、完全开放/关闭某个端口

# 开放端口
sudo ufw allow <port>
# 关闭端口
sudo ufw delete allow <port>

示例：

# 开放 443 端口
sudo ufw allow 443
# 关闭 443 端口
sudo ufw delete allow 443

12.4、对于某个网段开放/关闭某个端口

sudo ufw allow from <network> to any port <port>
sudo ufw delete allow from <network> to any port <port>

示例：

# 对 192.168.1.0/24 开放 443 端口
sudo ufw allow from 192.168.1.0/24 to any port 443
# 对 192.168.1.0/24 关闭 443 端口
sudo ufw delete allow from 192.168.1.0/24 to any port 443

13、rsync

13.1、安装

sudo apt update && sudo apt install -y rsync

13.2、说明

rsync <参数> [源路径] [目标路径]

[!TIP] 路径结尾的 / 表示目录内容，省略 / 表示则整个目录

[!NOTE] 参数说明：
-r 递归复制
-a 归档模式（保留权限、属性、递归目录）
-v 显示详细过程
-h 显示人类可读的文件大小
-n 模拟运行（不实际同步）
-z 在文件传输过程中进行压缩
--progress 显示传输进度
--delete 同步时删除目标目录中多余的文件
--exclude 排除不需要同步的目录（例如 *.tmp 或 /folder1/folder2）
--include 选择需要同步的目录（例如 *.tmp 或 /folder1/folder2）
--checksum 严格校验内容
--inplace 跳过临时文件创建
--ignore-existing：跳过目标端已存在的文件

示例：

rsync -rvh --progress --inplace --delete \
  --include='/aria2/***' \
  --include='/homepage/***' \
  --include='/openlist/***' \
  --include='/outline/***' \
  --exclude='*' \
  /mnt/sc001xt_1/.project/ /mnt/s3fs/backup1/.project/

rsync -rvh --progress --inplace --delete \
  --exclude='/.project/' \
  /mnt/sc001xt_1/ /mnt/s3fs/backup1/

14、unzip

14.1、安装

sudo apt update && sudo apt install -y unzip

14.2、说明

# 解压到当前目录
unzip <zip_path>

# 解压到指定目录
unzip <zip_path> -d <target_directory>

# 列出压缩包内容
unzip -l <zip_path>

示例：

# 解压 example.zip 到当前目录
unzip example.zip

# 解压 example.zip 到 ./folder/
unzip example.zip -d ./folder/

# 列出 example.zip 的内容
unzip -l example.zip

15、7zip-full

15.1、安装

sudo apt update && sudo apt install -y 7zip-full

15.2、说明

# 解压到当前目录
7z x <7z_path>

# 解压到指定目录
7z x <7z_path> -o<target_directory>

# 列出压缩包内容
7z l <7z_path>

示例：

# 解压 example.7z 到当前目录
7z x example.7z

# 解压 example.7z 到 ./folder/
7z x example.7z -o./folder/

# 列出 example.7z 的内容
7z l example.7z

16、screen

16.1、安装

sudo apt update && sudo apt install -y screen

16.2、说明

screen <选项> [会话名或命令]

[!NOTE] 常用选项：
-S 创建新会话
-ls 列出所有会话
-r 重新连接已分离的会话
-R 尝试恢复会话，不存在则新建
-d 分离其他已连接的会话
-D 强制断开并分离会话
-x 连接到已连接的会话（多人共享屏幕）
-X <command> 在指定会话中执行 screen 命令
-dmS <name> <command> 创建后台守护会话并运行命令
-wipe 清除死去的会话

示例：

# 创建会话
screen -S myserver

# 删除会话
screen -S myserver -X quit

# 列出所有会话
screen -ls

# 重新连接到会话
screen -r myserver

# 强制重新连接到会话
screen -D -r myserver

# 创建后台会话运行脚本
screen -dmS myserver ./start_server.sh

# 连接到已连接的会话（多人共享查看）
screen -x myserver

# 清除死去的会话  
screen -wipe

[!TIP] 在会话内按 <kbd>Ctrl</kbd> + <kbd>A</kbd> + <kbd>D</kbd> 可退出当前会话

Markdown 教程

Wed, 12 Nov 2025 00:00:00 GMT

前言

虽说这篇文章的标题是「Markdown 教程」，但我本人实际上并不常用 Markdown 进行写作，对 Markdown 的了解并不深入，所以这篇文章理论上更应该是我自己的「Markdonw 备忘录」，如有不足，欢迎补充。

1、通用语法

1.1、文本格式

Markdown 段落的换行是使用两个以上 空格 加上 回车

段落后面使用一个空行来表示重新开始一个段落

1.2、标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

[!TIP] 注意事项：
1、# 和 标题文本 之间必须有一个空格
2、# 必须在行首，前面不能有其他字符

1.3、字体

斜体语法：使用 * 或 _ 包围文字
例如：斜体文本

粗体语法：使用 ** 或 __ 包围文字
例如：粗体文本

粗斜体组合：使用 *** 或 ___ 包围文字
例如：粗斜体文本

1.4、分割线

***
* * *
*****
- - -
----------

1.5、删除线

使用 ~~ 包围文字
例如：~~删除线文本~~

1.6、下划线

使用  和  包围文字
例如：下划线文本

1.7、脚注

这是一个脚注 [^Footnote]

[^Footnote]: 如你所见，这确实是一个脚注

1.8、行内代码标记

通常使用 ` 包围文字
例如：git commit

当包含反引号时，适用 `` 包围文字
例如：This is a `text enclosed in backticks`

1.9、列表

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

1. 第一项
2. 第二项
3. 第三项

示例：

第一项
第二项
第三项

第一项
第二项
第三项

[!TIP] 注意事项：
1、* + - 1. 2. ... 和 列表文本 之间必须有一个空格
2、* + - 1. 2. ... 必须在行首，前面不能有其他字符

1.10、引用块

> 第一行  
> 第二行  
> 第三行

或者

> 第一行  
第二行  
第三行

示例：

第一行
第二行
第三行

[!TIP] 注意事项：
1、> 和 引用内容 之间必须有一个空格
2、> 必须在行首，前面不能有其他字符

1.11、代码区块

用 ``` 包裹一段代码，并指定一种语言，也可以不指定

```python
print("Hello World")
```

示例：

print("Hello World")

[!NOTE] 常用语言标识符列表:

javascript / js

python / py

html

css

sql

json

xml

yaml / yml

bash / shell

java

cpp / c++

csharp / c#

php

ruby / rb

go

rust

typescript / ts

1.12、链接

* 1.12.1、基础链接

[text1](url)  
[text2](url "title")  
<url>

示例：

text1
text2
http://www.google.com

* 1.12.2、参考链接

参考链接 将链接定义与使用分离，适合需要多次引用相同链接的情况

[text1][label]
[text2][label]

[label]: url "title"

示例：

text1
text2

* 1.12.3、锚点链接

锚点链接 用于在同一文档内跳转，特别适合长文档的导航

## 目录
- [第一章：介绍](#第一章介绍)
- [第二章：安装](#第二章安装)
- [第三章：使用方法](#第三章使用方法)

# 第一章：介绍
这里是介绍内容...

# 第二章：安装
这里是安装说明...

# 第三章：使用方法
这里是使用说明...

<a id="custom-anchor"></a>

[跳转到自定义位置](#custom-anchor)

[回到顶部](#)

1.13、图片

# 使用图片链接
![text1](url)
![text2](url "title")

# 使用图片路径 (相对路径或绝对路径)
![text1](path)
![text2](path "title")

# 图片链接组合
[![text1](image_url)](link_url)

# HTML 方式
<img src="image.jpg" alt="text1" width="300" height="200">
<img src="image.jpg" alt="text2" width="50%">
<img src="image.jpg" alt="text3" style="width: 300px; height: auto;">

1.14、表格

* 1.14.1、表格基础语法

| 表头 | 表头 | 表头 |
| --- | --- | --- |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

示例：

表头	表头	表头
单元格	单元格	单元格
单元格	单元格	单元格

[!TIP] 语法要点：

表头 和 单元格 之间必须有 分隔线

分隔线 至少需要三个连字符 ---

两端的竖线 | 是可选的，但建议保留以提高可读性

* 1.14.2、表格扩展语法

修改 分割线 可以设置表格的对齐方式

| 表头 | 表头 | 表头 |
| --- | :---: | ---: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

[!NOTE] 对齐方式：
---: 设置 表头 和 单元格 居右对齐
:--- 设置 表头 和单元格 居左对齐
:---: 设置 表头 和单元格 居中对齐

1.15、LaTeX 数学公式

在 Markdown 中，数学公式通过 LaTeX 语法来表示

[!NOTE] 基本语法结构
命令：以反斜杠 \ 开头，如 \alpha、\sum
参数：用花括号 {} 包围，如 \frac{a}{b}
下标：使用 _，如 x_1
上标：使用 ^，如 x^2
分组：用花括号将多个字符组合，如 x_{i+1}

常用 LaTeX 命令

\alpha, \beta, \gamma  # 希腊字母
\sum, \prod, \int      # 求和、乘积、积分
\frac{分子}{分母}      # 分数
\sqrt{表达式}          # 平方根
\sqrt[n]{表达式}       # n次根

* 1.15.1、行内公式

行内公式使用单个 $ 包围，公式会嵌入到文本中
例如：文本中的变量 $x = 5$ 和函数 $f(x) = x^2 + 2x + 1$
显示：文本中的变量 $x = 5$ 和函数 $f(x) = x^2 + 2x + 1$。

* 1.15.2、块级公式

块级公式使用双美元符号 $$ 包围，公式会独立成行并居中显示

例如：

$$E = mc^2$$

$$\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$$

显示：

$$E = mc^2$$

$$\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$$

* 1.15.3、扩展公式

使用 align 环境可以创建多行公式

例如：

$$
    \begin{align}
    f(x) &= ax^2 + bx + c \\
    f'(x)  &= 2ax + b \\
    f''(x)  &= 2a
    \end{align}
$$

显示：

$$ \begin{align} f(x) &= ax^2 + bx + c \ f'(x) &= 2ax + b \ f''(x) &= 2a \end{align} $$

使用 matrix 环境可以创建矩阵

例如：

$$
    \begin{pmatrix}
    a & b \\
    c & d
    \end{pmatrix}
$$

显示：

$$ \begin{pmatrix} a & b \ c & d \end{pmatrix} $$

[!NOTE] 不同括号类型的矩阵：
pmatrix 圆括号 $\begin{pmatrix} a & b \ c & d \end{pmatrix}$
bmatrix 方括号 $\begin{bmatrix} a & b \ c & d \end{bmatrix}$
vmatrix 行列式 $\begin{vmatrix} a & b \ c & d \end{vmatrix}$

* 1.15.4、常用数学符号

[!NOTE] 基本运算符号
加减乘除：+, -, \times, \div
分数：\frac{a}{b}
根号：\sqrt{x}, \sqrt[n]{x}
指数：x^2, e^{i\pi}

[!NOTE] 比较符号
等于：=, \neq, \equiv
大小：<, >, \leq, \geq
约等于：\approx, \sim

[!NOTE] 集合符号
属于：\in, \notin
包含：\subset, \supset
交并：\cap, \cup
空集：\emptyset

[!NOTE] 特殊函数和符号
三角函数：\sin, \cos, \tan
对数：\log, \ln
极限：\lim_{x \to 0}
求和：\sum_{i=1}^{n}
积分：\int_{a}^{b}
无穷：\infty

希腊字母

小写	大写	LaTeX	小写	大写	LaTeX
α	Α	\alpha	ν	Ν	\nu
β	Β	\beta	ο	Ο	o
γ	Γ	\gamma	π	Π	\pi
δ	Δ	\delta	ρ	Ρ	\rho
ε	Ε	\epsilon	σ	Σ	\sigma
θ	Θ	\theta	τ	Τ	\tau
λ	Λ	\lambda	φ	Φ	\phi
μ	Μ	\mu	ω	Ω	\omega

1.16、使用 HTML 元素

不在 Markdown 涵盖范围之内的标签，可以用 HTML 撰写

例如：使用 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Del</kbd> 可以重启电脑

显示：使用 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Del</kbd> 可以重启电脑

例如：这是一段高亮文本

显示：这是一段高亮文本

例如：

<details>
  <summary>这是一个折叠内容</summary>
  <p>不过里面没有任何信息</p>
</details>

<details open>
  <summary>这个板块默认是展开的</summary>
  <p>不过里面也没有任何信息</p>
</details>

显示：

<details> <summary>这是一个折叠内容</summary> 不过里面没有任何信息 </details>

<details open> <summary>这个板块默认是展开的</summary> 不过里面也没有任何信息 </details>

1.17、转义

Markdown 使用了很多特殊的符号来表示特定的意义，如果需要显示特殊的符号则需要使用转义字符

**文本加粗** 
\*\*正常显示星号\*\*

示例：

文本加粗
**正常显示星号**

Markdown 支持以下这些符号前面加上 \ 来作为普通的符号插入

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

1.18、视频

# Youtube
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

# Bilibili
<iframe width="100%" height="468" src="//player.bilibili.com/player.html?bvid=BV1fK4y1s7Qf&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

2、扩展语法

随着时间的推进，创作者的开发，现如今，不同的 Markdown 扩展已经支持了各种各样的扩展语法
而 Fuwari 使用的就是 Expressive Code

2.1、内容隐藏

这个内容 :spoiler[隐藏了]!

示例：

这个内容 :spoiler[隐藏了]!

2.2、Github 卡片

::github{repo="bysansheng/AniSort"}

示例：

::github{repo="bysansheng/AniSort"}

2.3、扩展引用

> [!NOTE]
> This is a note

> [!TIP]
> This is a tip

> [!WARNING]
> This is a warning

示例：

[!NOTE] This is a note

[!TIP] This is a tip

[!WARNING] This is a warning

2.4、扩展代码区块

* 2.4.1、标题

```py title="this is a py"
print("Hello World!")
```

```bash title="this is a bash"
du -h /var/log/
```

```bash frame="code" title="this is a bash"
du -h /var/log/
```

示例：

print("Hello World!")

du -h /var/log/

du -h /var/log/

* 2.4.2、行号

显示行号

```py showLineNumbers
print("Hello World!")
print("Truth is 114514")
```

示例：

print("Hello World!")
print("Truth is 114514")

隐藏行号

```py showLineNumbers=false
print("Hello World!")
print("Truth is 114514")
```

示例：

print("Hello World!")
print("Truth is 114514")

修改起始行号

```py showLineNumbers startLineNumber=5
print("Greetings from line 5")
print("Hello World!")
print("Truth is 114514")
```

示例：

print("Greetings from line 5")
print("Hello World!")
print("Truth is 114514")

* 2.4.3、折叠

```js collapse={2-3, 5-8}
// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
// Line 9
```

示例：

// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
// Line 9

* 2.4.4、自动换行

开启自动换行

```py wrap
print("114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514")
```

```js wrap preserveIndent
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}
```

```js wrap preserveIndent=false
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}
```

示例：

print("114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514")

function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

关闭自动换行

```py wrap=false
print("114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514")
```

示例：

print("114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514114514")

* 2.4.5、行标记

标记指定行

```js {1, 4-6, 8} 
// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
// Line 9
```

示例：

// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
// Line 9

选择标记类型 (make, ins, del)

```js {2} del={4} ins={6-7}
// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
```

示例：

// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8

为标记添加标签

```js {"1": 2} del={"2": 5-6} ins={"This is a ins": 8}
// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
// Line 9
```

示例：

// Line 1
// Line 2
// Line 3
// Line 4
// Line 5
// Line 6
// Line 7
// Line 8
// Line 9

类似 diff 的语法

```diff
+this line will be marked as inserted
-this line will be marked as deleted
this is a regular line
```

示例：

+this line will be marked as inserted
-this line will be marked as deleted
this is a regular line

* 2.4.6、文本标记

标记指定文本

```js "given text"
function demo() {
  // Mark any given text inside lines
  return 'Multiple matches of the given text are supported';
}
```

示例：

function demo() {
  // Mark any given text inside lines
  return 'Multiple matches of the given text are supported';
}

正则表达式

```ts /ye[sp]/
console.log('The words yes and yep will be marked.')
```

示例：

console.log('The words yes and yep will be marked.')

选择标记类型 (make, ins, del)

```js "return true;" ins="inserted" del="deleted"
function demo() {
  console.log('These are inserted and deleted marker types');
  // The return statement uses the default marker type
  return true;
}
```

示例：

function demo() {
  console.log('These are inserted and deleted marker types');
  // The return statement uses the default marker type
  return true;
}

参考文档

Markdown 教程 - 菜鸟教程

Fuwari 搭建教程：我的第一个轻量级静态博客

Tue, 11 Nov 2025 00:00:00 GMT

前言

对于大多数人而言，《如何搭建一个博客》可能既是他们的第一篇博文，也是他们的最后一篇博文。在此落笔，我也不免有类似的担忧，以前我不愿搭建博客，不是因为我没有相应的理论知识和实操能力，而是我向来不乐意写东西来表达自己。这次搭建博客，只希望能有所坚持，哪怕是月更、年更也好。

回归正题，如果你对搭建 Fuwari 感兴趣，可以先看看官方项目地址和官方演示站。

1、环境配置

[!TIP] Node.js <= 22
pnpm <= 9
Nginx == *

如果你已经有了相应的环境，可以跳过该部分

1.1、安装 Nginx

# 安装并启动 Nginx
sudo apt update && sudo apt install -y nginx
sudo systemctl --now enable nginx

# 验证
nginx -v

# 删除默认配置
rm -rf /etc/nginx/sites-available/default /etc/nginx/sites-enabled/default

1.2、安装 Node.js

# 安装 Node.js 相关
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g pnpm

# 配置 pnpm 包存储路径
pnpm config set store-dir "/root/pnpm-store"

# 验证
node -v
npm -v
pnpm -v

1.3、安装 rsync

sudo apt update && sudo apt install -y rsync

2、部署 Fuwari

2.1、新建文件夹

[!TIP] 所有 <path> 请自行替换成个人实际目录

mkdir -p <path>/fuwari/ && cd <path>/fuwari/

2.2、下载 Fuwari

获取 Fuwari 源码

git clone https://github.com/saicaca/fuwari.git .

也可自行添加代理，例如：

git -c http.proxy="http://127.0.0.1:8118" \
  clone https://github.com/saicaca/fuwari.git .

2.3、安装环境

pnpm install

2.4、构建网站

pnpm build

配置文件权限

sudo chmod -R 777 ./dist/

2.5、配置 Nginx 反代

sudo nano /etc/nginx/sites-available/fuwari.conf

在其中添加或修改自己的配置：

server {
    listen 41482;
    listen [::]:41482;
    server_name _;

    root <path>/fuwari/dist/;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

<summary>这里附上我本人使用的配置</summary>

[!TIP] 所有 <domain> 请自行替换成个人实际域名

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;

    return 403;
}

server {
    listen 80;
    listen [::]:80;
    server_name <domain>;

    root <path>/fuwari/dist/;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

</details>

链接 Nginx

sudo ln -s /etc/nginx/sites-available/fuwari.conf /etc/nginx/sites-enabled/

暴露端口

sudo ufw allow 41482

重启 Nginx

sudo systemctl restart nginx

然后就可以打开 http://localhost:41482 访问 fuwari 的 Web 页面

3、自定义

3.1、修改主页面

sudo nano ./src/config.ts

可以根据自己的喜好和需求进行修改

title 博客主标题
subtitle 博客副标题
lang 博客语言。注释已经列出了一些常用的值，如：en, zh_CN, zh_TW, ja, ko
themeColor 博客主题色，可以在你的博客右上角的画板图标确定喜欢的颜色再填写
banner > src 即 banner 图片，支持 http/https URL
favicon > src 即网站图标，支持 http/https URL
avatar 即你的头像
name 即你的名字
bio 即你的个性签名
icon 图标。可以前往 icones.js 去搜索想要的图标，比如 QQ，则填写 fa6-brands:qq，Fuwari 默认支持这几种类型：fa6-brands, fa6-regular, fa6-solid, material-symbols。可以在 ./astro.config.mjs 中搜索关键字进行配置

3.2、修改文章末尾的博客域名

[!TIP] 所有 <domain> 请自行替换成个人实际域名

Fuwari 会在每篇文章的末尾，放上相关信息，例如当前文章的标题、链接、作者、许可协议之类的。其中文章链接所使用的域名默认为 fuwari.vercel.app，需要自行修改。

sudo nano astro.config.mjs

在其中修改文章末尾的博客域名：

export default defineConfig({
	site: "https://fuwari.vercel.app/",
	site: "https://<domain>/",
	base: "/",
	trailingSlash: "always",
	integrations: [
		tailwind({
			nesting: true,
		}),
		swup({

3.3、添加导航栏页面

如果你看过其他人基于 Fuwari 搭建的博客，会发现他们的导航栏有很多原生并没有的页面，这就是通过自行添加导航栏页面实现的。

* 3.3.1、添加页面

[!TIP] 所有 <page_file_name> 请自行替换成个人实际的页面文件名

sudo nano ./src/pages/<page_file_name>.astro

然后可以根据 Astro 的组件模板进行页面的编写

具体可以前往 https://docs.astro.build/zh-cn/basics/astro-components 进行查看

同时，Astro 也支持使用 TailwindCSS 进行样式编辑

具体可以前往 https://www.tailwindcss.cn/docs/installation 进行查看

* 3.3.2、应用页面

[!TIP] 所有 <page_display_name> 请自行替换成个人实际的页面展示名

sudo nano ./src/config.ts

在 links 中可以自行应用页面：

export const navBarConfig: NavBarConfig = {
	links: [
		LinkPreset.Home,
		LinkPreset.Archive,
		LinkPreset.About,
		{
			name: "<page_display_name>",
			url: "/<page_file_name>/",
			external: false,
		},
	],
};

3.4、添加置顶功能

Fuwari 原生并不支持文章的置顶，需要手动修改相应文件。

* 3.4.1、修改排序逻辑

sudo nano ./src/utils/content-utils.ts

将 getRawSortedPosts 函数中的排序逻辑修改为：

async function getRawSortedPosts() {
	const allBlogPosts = await getCollection("posts", ({ data }) => {
		return import.meta.env.PROD ? data.draft !== true : true;
	});

	const sorted = allBlogPosts.sort((a, b) => {
    if (a.data.pinned !== b.data.pinned) {
      return a.data.pinned ? -1 : 1;
    }
		const dateA = new Date(a.data.published);
		const dateB = new Date(b.data.published);
		return dateA > dateB ? -1 : 1;
	});
	return sorted;
}

* 3.4.2、修改文章配置文件

sudo nano ./src/content/config.ts

在 lang 字段后增加 pinned 字段

		tags: z.array(z.string()).optional().default([]),
		category: z.string().optional().nullable().default(""),
		lang: z.string().optional().default(""),
		pinned: z.boolean().optional().default(false),

		/* For internal use */
		prevTitle: z.string().default(""),
		prevSlug: z.string().default(""),
		nextTitle: z.string().default(""),

* 3.4.3、修改置顶显示标签

sudo nano ./src/components/PostCard.astro

此文件需要修改两处

const { remarkPluginFrontmatter } = await entry.render();

const isPinned = entry.data.pinned === true;
---
<div class:list={["card-base flex flex-col-reverse md:flex-col w-full rounded-[var(--radius-large)] overflow-hidden relative", className]} style={style}>
    <div class:list={["pl-6 md:pl-9 pr-6 md:pr-2 pt-6 md:pt-7 pb-6 relative", {"w-full md:w-[calc(100%_-_52px_-_12px)]": !hasCover, "w-full md:w-[calc(100%_-_var(--coverWidth)_-_12px)]": hasCover}]}>
        {isPinned && (
            <div class="absolute top-4 right-3 text-[var(--primary)]">
                <Icon name="material-symbols:push-pin" class="w-5 h-5" />
            </div>
        )}
        <a href={url}
           class="transition group w-full block font-bold mb-3 text-3xl text-90
        hover:text-[var(--primary)] dark:hover:text-[var(--primary)]

3.5、添加 astro-seo

Fuwari 原生的搜索功能并不太好用，使用 astro-seo 可以在一定程度上优化博客的搜索功能。

* 3.5.1、安装 astro-seo

pnpm install astro-seo

* 3.5.2、应用 astro-seo

sudo nano ./src/layouts/Layout.astro

导入 astro-seo，然后在 HTML 的 <head> 部分中使用该组件

const bannerOffset =
	bannerOffsetByPosition[siteConfig.banner.position || "center"];

import { SEO } from "astro-seo";
---

<!DOCTYPE html>
<html lang={siteLang} class="bg-[var(--page-bg)] transition text-[14px] md:text-[16px]"
	  data-overlayscrollbars-initialize
>
	<head>

		<SEO
			title={pageTitle}
			description={description || pageTitle}
		/>

		<title>{pageTitle}</title>

		<meta charset="UTF-8" />
		<meta name="description" content={description || pageTitle}>

也可以前往 https://github.com/jonasmerlin/astro-seo 查看其它自定义内容

::github{repo="jonasmerlin/astro-seo"}

3.6、重新构建网站

[!TIP] 每次修改完自定义内容后都要进行一次网站的构建。

pnpm build

4、文章编写

Fuwari 作为一个静态博客，虽然轻量美观，但是文章的编写还是有一定的麻烦的，以下作为 文章编写 的后续补充

4.1、新建文章

pnpm new-post <filename>

之后可以在 src/content/posts/ 目录中编辑相应的 Markdown 文件

---
title: Default Example
published: 1919-08-10
description: ''
image: ''
tags: []
category: ''
draft: true 
lang: ''
pinned: false
---

...

title 文章标题
published 文章创建时间
description 文章描述
image 文章封面图
tags 文章标签
category 文章分类
draft 是否为草稿
lang 文章语言
pinned 是否置顶

4.2、重新构建网站

[!TIP] 每次编写完文章后都要进行一次网站的构建。

pnpm build