小王的博客

【工具】GitHub 多账号 SSH 配置完整指南

2026-10-13T10:00:00.000Z

前言#

很多人电脑上会有两个及以上的 GitHub 账号，比如一个是工作号、一个是个人号。默认的 SSH 配置只有一个私钥，当你用账号 A 的密钥去访问账号 B 的仓库时，GitHub 会认为你是账号 A，而账号 A 没有 B 仓库的权限，直接报”仓库不存在”。

这个问题的根源是：两个仓库用了同一个 SSH 地址 git@github.com。解决方法很简单——给每个账号单独配一套密钥，再用 .ssh/config 起个别名，B 的仓库 remote 改成别名地址就完事了。

第一步：生成两套独立的 SSH 密钥#

打开 Git Bash 或 PowerShell，执行以下命令：

Terminal window

1
# A 账号密钥（如果已有可以跳过）
2
ssh-keygen -t ed25519 -C "账号A的github邮箱" -f ~/.ssh/id_gh_a
3

4
# B 账号密钥（重点，新建这个）
5
ssh-keygen -t ed25519 -C "账号B的github邮箱" -f ~/.ssh/id_gh_b

提示输入 passphrase 时，可以直接回车用空密码，也可以设置密码（推荐）。

生成完毕后，把两个公钥分别添加到对应账号：

Terminal window

1
# 查看公钥内容
2
cat ~/.ssh/id_gh_a.pub
3
cat ~/.ssh/id_gh_b.pub

然后分别登录 GitHub：

账号 A → Settings → SSH and GPG keys → New SSH key → 粘贴 id_gh_a.pub 内容
账号 B → Settings → SSH and GPG keys → New SSH key → 粘贴 id_gh_b.pub 内容

第二步：创建 / 修改 `~/.ssh/config`#

Windows 路径：C:\Users\你的用户名\.ssh\config

⚠️ 注意：文件名叫 config，不要加任何后缀（比如 .txt），编码用 UTF-8。

写入以下内容：

1
# GitHub 账号A
2
Host gh-a
3
  HostName github.com
4
  IdentityFile ~/.ssh/id_gh_a
5
  User git
6

7
# GitHub 账号B
8
Host gh-b
9
  HostName github.com
10
  IdentityFile ~/.ssh/id_gh_b
11
  User git

含义解释：

Host gh-a：给这个连接起个别名叫 gh-a，以后用这个别名代替 github.com

HostName github.com：实际连接的服务器

IdentityFile：使用哪个私钥

User git：SSH 连接 GitHub 使用的用户名（固定写 git）

第三步：测试连通性#

Terminal window

1
# 测试账号 A
2
ssh -T gh-a
3

4
# 测试账号 B
5
ssh -T gh-b

成功的话会看到类似这样的输出：

1
Hi B用户名! You've successfully authenticated, but GitHub does not provide shell access.

第四步：修改 B 仓库的 remote 地址#

进入账号 B 的本地仓库目录，先把当前的 remote 地址看一下：

Terminal window

1
git remote -v

原来大概率是 git@github.com:Bname/repo.git，这个会默认读取 id_gh_a，必须改成别名 gh-b：

Terminal window

1
git remote set-url origin gh-b:B用户名/仓库名.git

改完后验证一下：

Terminal window

1
git remote -v
2
# 应该看到 origin 用的是 gh-b:...

第五步：设置本仓库独立的提交作者#

现在 B 仓库用的密钥对了，但 commit 的 author 还是全局配置的 A 账号信息。用 --local 只在本仓库生效，不影响其他仓库：

Terminal window

1
git config --local user.name "B的GitHub用户名"
2
git config --local user.email "B的GitHub邮箱"

✅ --local 只作用当前仓库，不会污染 A 仓库的配置！

验证配置：

Terminal window

1
git config --local --list

第六步：以后的使用规范#

养成习惯，克隆的时候直接带上别名：

Terminal window

1
# 克隆 A 账号的仓库
2
git clone gh-a:A用户名/repo.git
3

4
# 克隆 B 账号的仓库
5
git clone gh-b:B用户名/repo.git

快速自检命令#

遇到问题先跑这三个，基本能定位：

Terminal window

1
# 看当前仓库 git 配置
2
git config --local --list
3

4
# 看远程地址
5
git remote -v
6

7
# 测试 B 账号 SSH 连通
8
ssh -T gh-b

常见报错：`Permission denied (publickey)` 排查#

遇到这个报错的核心原因是：SSH 找到了私钥，但 GitHub 拒绝了该公钥身份。最常见的根因是 remote 地址写错了。

高频坑：remote 地址写错了#

❌ 错误写法（把别名当成了用户名）：

1
gh-b@github.com:用户名/仓库名.git

gh-b 是你本地 config 里的 Host 别名，不是用户名。SSH 连接 GitHub 的固定用户名是 git，这个在 config 里已经写死了。

✅ 正确写法（直接用别名冒号分隔）：

1
gh-b:用户名/仓库名.git

修正命令（进入仓库目录执行）：

Terminal window

1
git remote set-url origin gh-b:B的GitHub用户名/仓库名.git

示例：B 账号名叫 wangbin247，仓库叫 demo：

Terminal window

1
git remote set-url origin gh-b:wangbin247/demo.git

按顺序排查（先测试 SSH 连通性）#

Terminal window

1
ssh -T gh-b

情况一：依旧返回 `Permission denied (publickey)`#

说明公钥没有正确添加到 B 账号。按以下步骤检查：

完整复制公钥内容（以 ssh-ed25519 开头，结尾是邮箱）：
Terminal window
```
1
cat ~/.ssh/id_gh_b.pub
```
登录 B 账号 GitHub 网页 → Settings → SSH and GPG keys → New SSH key
粘贴进去，标题随便写，添加

⚠️ 公钥必须加到 B 账号，不要加到 A 账号！

情况二：返回成功 `Hi B用户名! You've successfully authenticated...`#

SSH 连通正常，问题在 git remote 地址，按下面的优先级检查：

确认 config 内容正确（Host 名称、IdentityFile 路径）：

1
Host gh-b
2
  HostName github.com
3
  IdentityFile ~/.ssh/id_gh_b
4
  User git

确认 remote 地址格式正确（见上面的正确写法）
确认 B 账号对该仓库有读写权限（私有仓库必须是 B 创建或被邀请为协作者）
确认公钥已添加到 B 账号（见情况一的步骤）

排查顺序总结#

1
ssh -T gh-b 失败 → 检查公钥是否添加到了 B 账号
2
ssh -T gh-b 成功 → 检查 git remote 地址格式是否正确

常见问题#

Q：已经 push 到远程的历史 commit 作者是 A，需要改吗？

不建议改。已 push 的历史 commit 重写作者会破坏协作，后续新提交用 B 就行。

Q：两个仓库能不能共用同一个 SSH 地址？

不能。这正是踩坑的根源，每个账号必须用不同的别名地址。

Q：ssh -T gh-b 返回权限被拒绝怎么办？

参考上面的【常见报错排查】，按顺序检查：公钥是否添加到 B 账号 → config 是否正确 → remote 地址格式是否正确。

总结#

步骤	操作	关键命令
生成密钥	为每个账号单独生成一对密钥	`ssh-keygen -t ed25519 -f ~/.ssh/id_gh_x`
配置别名	编辑 `~/.ssh/config` 设置 Host	`Host gh-b → IdentityFile ~/.ssh/id_gh_b`
修改 remote	B 仓库 remote 改用别名地址	`git remote set-url origin gh-b:user/repo.git`
设置本地作者	仅当前仓库生效	`git config --local user.name "B用户名"`

整个流程其实就四步：生成密钥 → 配 config → 改 remote → 设 local 作者。记住核心原则：每个账号一套密钥，每个仓库一个别名，就不会再踩坑了。

Linux 磁盘空间检查与新硬盘挂载完整指南

2026-08-18T10:00:00.000Z

前言#

在服务器运维过程中，经常需要为新硬盘挂载数据盘或扩展存储空间。银河麒麟 V10 作为国产主流 Linux 操作系统，其磁盘挂载流程与 CentOS/Ubuntu 基本一致，但也有自身的特点。本文整理自实际生产环境中的磁盘挂载操作，涵盖挂载前检查、完整挂载流程、常见问题解答三个部分，适合运维新手和有一定基础的同学参考。

一、挂载前磁盘检查#

1. 查看已挂载磁盘使用率#

Terminal window

1
df -h

重点关注以下字段：

字段	说明
`Size`	总大小
`Used`	已用空间
`Avail`	空闲空间
`Mounted on`	挂载点

2. 查看块设备，识别新硬盘#

Terminal window

1
lsblk

sda 是第一块盘，sdb 是第二块新硬盘；
没有 Mountpoint 列的设备，代表这块盘还没有挂载。

示例输出：

1
NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
2
sda      8:0    0    40G  0 disk
3
├─sda1   8:1    0   600M  0 part /boot/efi
4
├─sda2   8:2    0     1G  0 part /boot
5
└─sda3   8:3    0  38.4G  0 part
6
  ├─klas-root 253:0 0  34.4G  0 lvm  /
7
  └─klas-swap 253:1 0     4G  0 lvm  [SWAP]
8
sdb      8:16   0   300G  0 disk      ← 新硬盘，无挂载点

3. 查看磁盘分区详情#

Terminal window

1
sudo fdisk -l

该命令可以查看每块磁盘的详细分区信息，包括磁盘型号、扇区大小、磁盘标签类型等。

4. 查看目录占用空间#

当磁盘空间告警时，需要用 du 定位哪个目录占用大：

Terminal window

1
# 当前目录下各个目录大小
2
du -sh *
3

4
# 看根目录整体大目录
5
sudo du -sh /*

5. 检查 inode 是否耗尽#

有时候磁盘还有空间但无法写入文件，可能是 inode 用尽：

Terminal window

1
df -i

注意观察 IUse% 列，如果占用率为 100%，说明 inode 已耗尽，需要清理小文件。

二、新硬盘完整挂载流程#

假设新磁盘设备名为 /dev/sdb，挂载点为 /data

Step 1：分区（可选）#

如果是整块盘直接使用，可跳过此步；如需分区则执行：

Terminal window

1
sudo fdisk /dev/sdb

进入交互式界面后，依次输入：

1
g    → 创建 GPT 磁盘标签
2
n    → 新建分区
3
     → 回车（默认分区编号 1）
4
     → 回车（默认起始扇区）
5
     → 回车（默认结束扇区，使用全部空间）
6
w    → 写入分区表并退出

⚠️ 重要提醒：操作前务必确认设备名是 sdb，不要误操作 sda！如果操作失误，立即输入 q 退出，不保存修改。

Step 2：格式化（麒麟 V10 推荐 XFS）#

Terminal window

1
sudo mkfs.xfs /dev/sdb1

若跳过分直接格式化整块盘：sudo mkfs.xfs /dev/sdb

Step 3：创建挂载目录#

Terminal window

1
sudo mkdir -p /data

Step 4：临时挂载测试#

Terminal window

1
sudo mount /dev/sdb1 /data
2
df -h

确认挂载成功后，再配置开机自动挂载。

Step 5：获取 UUID 并配置开机自动挂载#

⚠️ 千万不要直接用 /dev/sdb1 写入 fstab，必须使用 UUID，否则磁盘设备名变化后系统将无法启动。

Terminal window

1
sudo blkid /dev/sdb1

复制输出的 UUID 值，编辑 /etc/fstab：

Terminal window

1
sudo vi /etc/fstab

在末尾新增一行：

1
UUID="你的UUID值"  /data  xfs  defaults  0  0

Step 6：校验 fstab 配置（极其重要！）#

Terminal window

1
sudo mount -a

无任何输出 = 配置正确。如果有报错，立即回去修改 /etc/fstab，写错可能导致系统无法开机。

三、挂载后确认#

Terminal window

1
df -h
2
lsblk

确认 /data 已正确挂载，空间可用。

四、常见问题：普通用户如何免 sudo 操作挂载目录#

挂载完磁盘到 /data，默认属主为 root，普通用户 yunwei 没有读写权限。以下是两种常用解决方案：

方案一：修改目录属主（推荐用于普通业务数据）#

Terminal window

1
sudo chown -R yunwei:yunwei /data
2
sudo chmod 755 /data

执行后，yunwei 用户可以直接读写 /data，无需 sudo。

Terminal window

1
su - yunwei
2
cd /data
3
touch test.txt
4
ls -l test.txt

方案二：MySQL 数据目录场景（特殊处理）#

如果 /data/mysql 存放 MySQL 数据，mysqld 进程运行用户是 mysql，不能直接将所有者改成 yunwei：

Terminal window

1
# 目录本身给 yunwei 访问权限
2
sudo chmod 755 /data
3
# mysql 数据目录归属 mysql 用户
4
sudo chown -R mysql:mysql /data/mysql

这种场景下，yunwei 可以通过 MySQL 客户端操作数据库，但不建议直接裸写数据文件，存在安全风险。

补充：让权限配置开机自动生效#

XFS 文件系统不支持在 fstab 中指定 uid/gid，因此每次重启后权限可能丢失。可以将授权写入 /etc/rc.local：

Terminal window

1
# 写入开机执行命令
2
sudo bash -c 'echo "chown -R yunwei:yunwei /data" >> /etc/rc.d/rc.local'
3

4
# 给 rc.local 执行权限
5
sudo chmod +x /etc/rc.d/rc.local

查看当前用户 UID/GID：

Terminal window

1
id yunwei
2
# 输出：uid=1000(yunwei) gid=1000(yunwei) 组...

五、总结#

步骤	关键命令	注意事项
检查磁盘	`df -h` / `lsblk` / `df -i`	关注空间、inode 使用情况
分区	`sudo fdisk /dev/sdb`	确认设备名，输入 `g`、`n`、`w`
格式化	`sudo mkfs.xfs /dev/sdb1`	麒麟推荐 XFS，不要格式化错盘
挂载测试	`sudo mount /dev/sdb1 /data`	先测试再写 fstab
配置开机	`sudo vi /etc/fstab` + UUID	必须用 UUID，不能用设备名
校验	`sudo mount -a`	无输出才表示配置正确
权限设置	`sudo chown -R yunwei:yunwei /data`	MySQL 数据目录需特殊处理

掌握了以上流程，面对大多数 Linux 服务器的磁盘挂载任务都能从容应对。如有 MySQL 数据迁移需求，可在挂载完成后进一步调整 datadir 配置。

【工具】一行命令激活 JetBrains 全家桶，再也不用东奔西跑了

2026-08-18T10:00:00.000Z

前言#

为了激活 JetBrains 的产品，网上搜索了一大堆，有的方法过时，有的是各种引流，四五个操作步骤，最后还不一定管用。别再东奔西跑，各种引导下载、关注公众号了，看完这篇就够了。

这条命令支持 JetBrains 全家桶（IntelliJ IDEA、PyCharm、GoLand、WebStorm、CLion 等等），包含最新的 2025.x 版本，真正一行命令搞定。

前置条件#

需要提前科学上网，否则脚本无法访问激活服务。

第一步：下载安装 JetBrains 产品#

去官网下载你需要的产品，包括但不限于：

IntelliJ IDEA
PyCharm
GoLand
WebStorm
CLion
DataGrip
Rider
… 以及全家桶其他产品

下载完后正常安装即可。

第二步：运行一次以生成配置文件#

安装完成后，一定要先运行一次，然后退出。

这一步的目的是让 JetBrains 在以下目录生成配置文件：

1
C:\Users\你的用户名\AppData\Roaming\JetBrains\

注意：不同产品版本路径中可能有版本号，例如 C:\Users\xxx\AppData\Roaming\JetBrains\IntelliJIdea2024.2\，不用管具体版本，有配置文件就行。

第三步：执行激活命令#

打开 PowerShell（不要用 CMD！）

以管理员身份运行 PowerShell，执行如下命令：

Terminal window

1
irm https://ckey.run/ | iex

命令解释：irm 是 Invoke-RestMethod 的别名，iex 是 Invoke-Expression 的别名，意思是下载并执行 ckey.run 上的脚本。

执行后一路回车即可。执行过程中脚本会自动下载 ja-netfilter 相关组件并配置好激活环境。

第四步：复制激活码#

命令执行完毕后会自动打开浏览器页面：

1
https://ckey.run/

如果没自动打开，手动访问上面的地址即可。

在页面上：

点击你想激活的产品，或者直接点击左上角的通用版
会弹出一个对话框，直接点确认（不想改什么的话）
确认后激活信息会自动复制到剪贴板

然后回到你的 JetBrains IDE，选择 Activation code 方式激活，粘贴刚才复制的内容，点击 OK，看到绿色提示就说明激活成功了。

第五步：配置防火墙（重要）#

激活完成后，记得在 Windows 防火墙中禁止对应 IDE 进程访问网络，防止被检测：

打开 Windows Defender 防火墙
点击「高级设置」→「出站规则」→「新建规则」
选择「程序」→ 找到对应的 exe 文件（如 idea64.exe）
选择「阻止连接」→ 全选 → 命名后保存

这一步是为了保证激活的稳定性，建议做一下。

其他平台#

macOS 用户#

评论区有热心网友提供了 Mac 版本的激活方式：

Terminal window

1
curl -L -o ckey.run ckey.run && bash ckey.run

执行方式和 Windows 类似，打开终端粘贴执行即可。

激活原理#

这个脚本底层使用的仍然是 ja-netfilter，版本是 ja-netfilter 2022.2.0。

下载的文件存放在以下目录，不要删除这个目录：

1
C:\Users\Public\.jb_run\

脚本的作用就是把整个手动配置过程自动化了，本质上是一样的原理，只不过不用你自己去 GitHub 找 jar 包、改配置了。

总结#

整个流程其实就三步：

下载安装 JetBrains 产品，运行一次
PowerShell 执行 irm https://ckey.run/ | iex
打开网页复制激活码，粘贴到 IDE 里

是不是比网上那些五六个步骤、各种下载引流的文章简洁多了？省下的时间够喝杯咖啡 ☕

有任何问题欢迎评论区交流~

GitHub热门项目！Tolaria：本地优先的Markdown知识库，让AI直接读你的笔记！

2026-08-04T00:00:00.000Z

朋友们！想让AI直接读你的笔记吗？#

做开发的朋友可能都有这种困扰：笔记散落在各个地方，AI找不到；想用AI处理知识，却不知道怎么组织；换个工具，数据就丢了…好家伙，今天给大家介绍一个神器——Tolaria！本地优先的Markdown知识库，Git版本控制，AI直接读你的笔记，完全开源，你的数据永远归你所有！

📚 项目介绍#

Tolaria 是一款基于Tauri的跨平台桌面应用（macOS、Windows、Linux），用于管理Markdown知识库。它的核心理念是文件优先、Git优先、离线优先，让你的笔记以标准Markdown文件存储，不被任何工具锁定。更重要的是，它天生支持AI集成，让Claude Code、Codex CLI等AI工具可以直接读取你的笔记！

核心特点#

📑 文件优先：笔记是纯Markdown文件，可移植，用任何编辑器都能打开
🔌 Git优先：每个知识库都是Git仓库，完整版本历史，支持任意远程
🛜 离线优先：无需账号、订阅、云依赖，完全离线可用
🔬 开源免费：AGPL-3.0协议，代码完全公开
📋 标准格式：Markdown+YAML Frontmatter，无专有格式
🔍 类型导航：类型是导航辅助，不是强制约束
🪄 AI优先：内置MCP Server，Claude Code、Codex CLI直接读笔记
⌨️ 键盘优先：为键盘用户设计，命令面板操作流畅
💪 实战驱动：作者自己用它管理10000+笔记，每个功能都解决真实问题

设计原则#

原则	说明
文件优先	纯Markdown，任何编辑器都能打开
Git优先	完整版本历史，零锁定
离线优先	无账号、无订阅、无云依赖
开源	免费开源，AGPL-3.0协议
标准格式	Markdown+YAML，无专有格式
AI优先	内置MCP，AI直接读笔记
键盘优先	为Power用户设计

🚀 安装方式#

方式一：Homebrew（macOS）#

Terminal window

1
brew install --cask tolaria

方式二：官网下载#

访问下载页面下载对应版本：

macOS：.dmg 文件
Windows：.exe 安装包（已签名）
Linux：.AppImage 或 .deb 文件

🎯 使用指南#

第一次启动#

首次打开Tolaria时，会提示克隆入门知识库，包含应用的完整使用教程。

创建知识库（Vault）#

打开Tolaria，点击「新建知识库」
选择存储位置（本地目录或Git仓库）
填写知识库名称
点击「创建」，Tolaria会自动初始化Git仓库

创建笔记#

点击「新建笔记」或使用快捷键
使用Markdown语法编写内容

添加YAML Frontmatter（可选）：

1
---
2
title: 笔记标题
3
date: 2026-08-04
4
type: article
5
tags: [标签1, 标签2]
6
---

保存笔记，Tolaria自动Git提交

使用Git同步#

Terminal window

1
# 添加远程仓库
2
cd /path/to/your/vault
3
git remote add origin https://github.com/user/your-vault.git
4

5
# 推送
6
git push -u origin main
7

8
# 其他设备克隆
9
git clone https://github.com/user/your-vault.git

AI集成（重点）#

Tolaria内置了MCP Server，让AI工具可以直接读取你的笔记：

配置Claude Code#

在Claude Code中配置MCP Server：

1
{
2
  "mcpServers": {
3
    "tolaria": {
4
      "command": "node",
5
      "args": ["/path/to/tolaria-mcp-server"]
6
    }
7
  }
8
}

配置Codex CLI#

Terminal window

1
# 在Codex CLI配置中添加MCP Server
2
codex configure add mcp tolaria \
3
  --command node \
4
  --args "/path/to/tolaria-mcp-server"

使用AGENTS文件#

Tolaria会为每个知识库生成AGENTS.md文件，告诉AI如何组织和读取笔记。你可以在AI工具中引用这个文件，让AI更好地理解你的知识库结构。

快捷键使用#

功能	macOS	Windows/Linux
命令面板	Cmd+K	Ctrl+K
新建笔记	Cmd+N	Ctrl+N
保存笔记	Cmd+S	Ctrl+S
全局搜索	Cmd+Shift+F	Ctrl+Shift+F
切换知识库	Cmd+1/2/3	Ctrl+1/2/3

💡 使用场景#

个人第二大脑#

用Tolaria管理你的个人知识库，记录想法、笔记、文章。通过Git同步，在多设备间无缝切换。配合AI功能，让AI成为你的知识助手。

公司文档管理#

将公司文档组织成Markdown知识库，让AI工具可以直接读取和分析。团队成员可以通过Git协作编辑，版本历史完整可追溯。

AI助手记忆存储#

为OpenClaw、Claude Code等AI助手提供记忆存储和程序知识库。AI可以直接读取你的笔记，更好地理解上下文。

技术写作与研究#

用Tolaria管理技术笔记、研究文档。类型系统帮助你按项目、主题、状态分类组织笔记。

日记与个人发展#

记录每日想法、反思、成长。通过搜索和筛选功能快速找到历史笔记。

📊 对比其他工具#

功能	Tolaria	Obsidian	Notion	Logseq
文件优先	✅	✅	❌ 云端	✅
Git集成	✅ 内置	⚠️ 插件	❌	⚠️ 插件
AI集成	✅ MCP内置	⚠️ 插件	✅	❌
离线使用	✅	✅	❌	✅
开源	✅ AGPL-3.0	✅	❌	✅
桌面应用	✅ Tauri	✅ Electron	✅ Web	✅ Electron
跨平台	✅	✅	✅	✅

📝 我的使用感受#

Tolaria是一款非常有思想的知识管理工具！作者是Refactoring的Luca Ronin，他自己用它管理10000+笔记，每个功能都解决了真实的痛点。

最让我惊喜的是文件优先的设计理念。你的笔记就是标准的Markdown文件，任何编辑器都能打开，完全没有锁定。配合Git版本控制，历史版本完整可追溯，数据真正属于你。

AI集成功能非常实用！内置的MCP Server让Claude Code可以直接读取你的笔记，AI不再是”智障”，而是真正理解你的知识库。AGENTS.md文件也让AI更容易理解你的知识库结构。

键盘优先的设计也很棒，命令面板操作流畅，快捷键覆盖全面，适合Power用户。

🎯 总结#

Tolaria是一款非常优秀的本地优先知识库工具，完全免费、开源（AGPL-3.0）。文件优先、Git优先、离线优先、AI优先…设计理念先进，功能实用。如果你想让AI直接读你的笔记，Tolaria绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/refactoringhq/tolaria

下载页面: https://refactoringhq.github.io/tolaria/download/

官方文档: https://refactoringhq.github.io/tolaria/

入门知识库: https://github.com/refactoringhq/tolaria-getting-started

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！OmniGet：一个App下载1800+网站，课程、视频、音乐全搞定！

2026-07-28T00:00:00.000Z

朋友们！下载视频、课程的工具太分散了？#

做自媒体、学网课的朋友应该都有这种困扰：下载YouTube用一个工具，下载Bilibili用另一个，下载Udemy课程又要找专门的脚本…每个工具都要单独配置，每个网站都要单独适配。更麻烦的是，好多工具只能用命令行，对小白用户极不友好！好家伙，今天给大家介绍一个神器——OmniGet！一个App搞定1800+网站，在线课程、视频、音乐、书籍全支持，内置播放器和阅读器，一键热键下载，完全开源免费！

📚 项目介绍#

OmniGet 是一款免费开源的桌面应用，支持Windows、macOS和Linux。它可以从1800+网站下载在线课程、视频、音频、音乐和书籍，下载的内容可以在App内直接播放和阅读。无需命令行，无需Python，无需配置，文件完全保存在本地。

核心特点#

🎓 在线课程下载：支持Udemy、Hotmart、Kiwify、Gumroad、Teachable、Kajabi、Skool、Wondrium、Thinkific、Rocketseat等
🎬 视频音频下载：YouTube、Instagram、TikTok、Twitter/X、Reddit、Twitch、Pinterest、Vimeo、Bluesky、Bilibili
🇨🇳 亚洲平台支持：抖音、小红书、快手、优酷、爱奇艺、腾讯视频、芒果TV
🖼️ 图片画廊：DeviantArt、Pixiv、ArtStation、Flickr、Tumblr、Imgur相册等
📦 文件传输：支持.torrent和磁力链接，支持P2P直传
⌨️ 一键热键：Ctrl+Shift+D（Mac: Cmd+Shift+D），复制链接按热键即可下载
🎵 内置播放器：视频、音频、课程直接播放，支持字幕和笔记
📖 内置阅读器：PDF、EPUB、CBZ漫画，支持高亮、书签、专注模式
🎵 音乐库管理：MP3、FLAC、M4A等，同步歌词，均衡器
🔌 插件系统：课程、学习、Telegram、转换等插件自动安装更新

下载能力#

分类	支持平台
在线课程	Hotmart、Udemy、Kiwify、Gumroad、Teachable、Kajabi、Skool、Wondrium、Thinkific、Rocketseat
视频音频	YouTube、Instagram、TikTok、Twitter/X、Reddit、Twitch、Pinterest、Vimeo、Bluesky、Bilibili
Bilibili深度	4K、HDR、杜比视界、Hi-Res无损、杜比全景声、弹幕、NFO
亚洲平台	抖音、小红书、快手、优酷、爱奇艺、腾讯视频、芒果TV
图片画廊	DeviantArt、Pixiv、ArtStation、Flickr、Tumblr、Kemono等

🚀 安装方式#

方式一：官网下载（推荐）#

访问 GitHub Releases 下载最新版本：

Windows：下载.exe文件，双击即可运行（便携版，无需安装）

macOS：打开.dmg，将OmniGet拖入Applications文件夹

Linux：

Terminal window

1
# Flatpak安装（推荐）
2
flatpak install wtf.tonho.omniget
3

4
# 或下载AppImage直接运行

首次启动说明#

由于OmniGet是开源软件，未购买代码签名证书，首次启动时系统可能会警告，这是正常现象：

macOS：

Terminal window

1
# 打开终端，运行以下两条命令（仅需一次）
2
xattr -cr /Applications/omniget.app
3
codesign --force --deep --sign - /Applications/omniget.app

Windows：点击”更多信息”→“仍要运行”即可

🎯 使用指南#

一键热键下载（最常用）#

复制任意链接（YouTube视频、Tweet、Discord消息、歌曲、磁力链接等）
按下全局热键 Ctrl+Shift+D（Mac: Cmd+Shift+D）
OmniGet自动读取剪贴板，后台下载
文件下载完成后自动保存到指定文件夹

💡 小技巧：在任何应用中都可以使用热键，浏览网页、聊天、阅读时随时下载

手动输入下载#

如果想先预览再下载：

打开OmniGet主界面
在搜索框中粘贴链接
查看预览和画质选项
点击下载按钮

Bilibili深度下载#

打开OmniGet设置
登录Bilibili账号（可选，登录后解锁4K、HDR、Hi-Res无损等）
复制Bilibili视频链接
按下热键或粘贴到搜索框
选择画质和下载选项

支持的URL类型：UP主主页、番剧、课程、收藏夹、每周必看、稍后再看、历史记录、b23.tv短链

批量下载#

方式一：文件批量

将多个链接保存到文本文件中
在OmniGet中选择”批量导入”
选择文本文件，开始批量下载

方式二：博主主页批量

复制博主主页链接
粘贴到OmniGet搜索框
选择批量下载所有作品

下载课程并观看#

复制Udemy/Hotmart等课程链接
粘贴到OmniGet，下载完整课程
下载完成后，在OmniGet内直接播放
支持断点续播，从上次停止的地方继续
可以添加笔记，笔记会跳转到对应时间点
支持侧边栏查看课程附件PDF

阅读书籍#

将PDF/EPUB/CBZ漫画文件拖入OmniGet
OmniGet自动提取封面、标题、作者
支持高亮、书签、专注模式
支持纸质阅读主题，护眼舒适

音乐库管理#

指向本地音乐文件夹
以iTunes风格展示：专辑封面、艺术家目录、播放队列
支持MP3、FLAC、M4A、OGG、Opus等格式
同步歌词，随歌曲滚动
连接Spotify、SoundCloud、YouTube Music、Qobuz、Last.fm
内置均衡器，多种预设

💡 使用场景#

学生党：在线课程下载#

下载Udemy、Hotmart等在线课程，在App内观看，支持笔记和断点续播。再也不用担心课程下架找不到资源了！

自媒体创作者：素材收集#

从YouTube、Bilibili、抖音等平台收集素材，批量下载，快速获取内容。支持4K、HDR等高质量下载。

音乐爱好者：音乐库管理#

管理本地音乐，同步歌词，连接流媒体平台。一个App搞定所有音乐需求。

书籍爱好者：电子书阅读#

将PDF、EPUB导入OmniGet，统一阅读体验。支持高亮、书签、专注模式。

研究者：资料收集#

从Reddit、Twitter/X、学术平台下载资料，批量保存，方便后续研究。

📝 我的使用感受#

OmniGet真的是一款让人惊艳的工具！以前下载视频、课程、音乐要用好几个工具，现在一个OmniGet全搞定！

最让我惊喜的是一键热键功能，复制链接按个热键就下载了，完全不用打开窗口，太方便了！而且下载速度很快，进度条和剩余时间显示准确。

内置的播放器和阅读器也很强大，下载的课程可以直接在App内观看，笔记功能也很实用。音乐库的同步歌词和均衡器功能也很贴心。

Bilibili的深度支持让我非常满意，登录后可以下载4K画质，还有弹幕功能，简直完美！

🎯 总结#

OmniGet是一款非常强大的全能下载工具，完全免费、开源（GPL-3.0）。1800+网站支持、在线课程下载、内置播放器/阅读器/音乐库、一键热键、批量下载…功能强大到让你挑花眼！如果你经常需要下载视频、课程、音乐、书籍，OmniGet绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/tonhowtf/omniget

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！

GitHub热门项目！HubProxy：Docker+GitHub加速神器，一个服务搞定所有镜像拉取！

2026-07-14T00:00:00.000Z

朋友们！Docker镜像拉取太慢？GitHub下载不了？#

做开发的朋友应该都遇到过这种情况：拉取Docker镜像半天不动，GitHub Release下载超时，Hugging Face模型下载失败…换了各种免费加速服务，要么不稳定，要么限流。好家伙，今天给大家介绍一个神器——HubProxy！一个服务搞定Docker镜像加速、GitHub文件加速、离线镜像下载，完全自托管，再也不用担心依赖第三方服务了！

📚 项目介绍#

HubProxy 是一个轻量级、高性能的多功能代理服务，基于Go语言开发，单二进制文件运行，资源占用极低。它提供Docker镜像加速、GitHub文件加速、离线镜像下载、在线搜索Docker镜像等功能，支持Docker Hub、GHCR、Quay等多个镜像仓库，是开发人员必备的加速工具！

核心特点#

🐳 Docker镜像加速：支持Docker Hub、GHCR、Quay、gcr.io、registry.k8s.io等多个镜像仓库，流式传输优化拉取速度
📁 GitHub文件加速：加速GitHub Release、Raw文件下载，支持api.github.com，脚本嵌套加速
📦 离线镜像包：支持下载离线镜像包，流式传输加防抖设计，方便离线部署
🤖 AI模型库支持：支持Hugging Face模型下载加速，训练大模型不再愁
🛡️ 智能限流：IP限流保护，防止滥用，支持白名单和黑名单
🔍 镜像搜索：在线搜索Docker镜像，快速找到需要的镜像
⚡ 轻量高效：基于Go语言，单二进制文件运行，资源占用低
🔧 统一配置：统一配置管理，便于维护
🛡️ 完全自托管：避免依赖免费第三方服务的不稳定性
🚀 多服务统一加速：单个程序即可统一加速Docker、GitHub、Hugging Face等多种服务

🚀 部署方式#

方式一：Docker部署（推荐）#

Terminal window

1
docker run -d \
2
  --name hubproxy \
3
  -p 5000:5000 \
4
  --restart always \
5
  ghcr.io/sky22333/hubproxy

方式二：Docker Compose#

1
version: '3.8'
2
services:
3
  hubproxy:
4
    image: ghcr.io/sky22333/hubproxy
5
    container_name: hubproxy
6
    ports:
7
      - "5000:5000"
8
    environment:
9
      - SERVER_PORT=5000
10
      - ENABLE_FRONTEND=true
11
      - IP_WHITELIST=127.0.0.1,192.168.1.0/24
12
    volumes:
13
      - ./config:/etc/hubproxy
14
    restart: always

方式三：脚本安装#

自动识别系统与架构，从GitHub Releases下载对应的安装包：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/sky22333/hubproxy/main/install.sh | sh

安装完成后，服务会自动启动。

🎯 使用指南#

Docker镜像加速#

方式一：直接使用加速地址

Terminal window

1
# 原命令
2
docker pull nginx
3

4
# 使用加速
5
docker pull yourdomain.com/nginx
6

7
# GHCR加速
8
docker pull yourdomain.com/ghcr.io/sky22333/hubproxy

方式二：配置为全局镜像加速

编辑 /etc/docker/daemon.json 文件：

1
{
2
  "registry-mirrors": [
3
    "https://yourdomain.com"
4
  ]
5
}

保存后重启Docker服务：

Terminal window

1
sudo systemctl restart docker

GitHub文件加速#

Terminal window

1
# 原链接
2
https://github.com/user/repo/releases/download/v1.0.0/file.tar.gz
3

4
# 加速链接
5
https://yourdomain.com/https://github.com/user/repo/releases/download/v1.0.0/file.tar.gz
6

7
# 加速下载仓库
8
git clone https://yourdomain.com/https://github.com/sky22333/hubproxy.git

Hugging Face模型加速#

Terminal window

1
# 原链接
2
https://huggingface.co/user/model/resolve/main/model.bin
3

4
# 加速链接
5
https://yourdomain.com/https://huggingface.co/user/model/resolve/main/model.bin

离线镜像下载#

Terminal window

1
# 下载单个镜像
2
curl -X POST http://yourdomain.com/api/download \
3
  -H "Content-Type: application/json" \
4
  -d '{"images": ["nginx:latest", "ubuntu:22.04"]}'
5

6
# 下载多个镜像
7
curl -X POST http://yourdomain.com/api/download \
8
  -H "Content-Type: application/json" \
9
  -d '{"images": ["ghcr.io/sky22333/hubproxy:latest", "redis:alpine"]}'

镜像搜索#

Terminal window

1
# 搜索镜像
2
curl http://yourdomain.com/api/search?q=nginx
3

4
# 搜索结果示例
5
{
6
  "results": [
7
    {
8
      "name": "nginx",
9
      "description": "Official build of Nginx.",
10
      "stars": 18000,
11
      "pulls": 1000000000
12
    }
13
  ]
14
}

📊 对比其他方案#

功能	HubProxy	免费第三方加速	Cloudflare Workers
Docker镜像加速	✅ 多仓库支持	✅ 部分支持	❌
GitHub文件加速	✅	✅	✅
离线镜像下载	✅	❌	❌
AI模型加速	✅	❌	❌
智能限流	✅	❌	❌
仓库审计	✅	❌	❌
完全自托管	✅	❌	❌
稳定性	✅ 自建可控	❌ 不稳定	⚠️ 限流

💡 使用场景#

开发团队：统一加速服务#

在团队中部署一个HubProxy服务，所有成员共享使用。无需每个人都配置不同的加速地址，统一管理，方便维护。同时智能限流保护服务不被滥用。

CI/CD流水线：加速构建过程#

在CI/CD流水线中使用HubProxy加速Docker镜像拉取和GitHub资源下载，大幅缩短构建时间，提升开发效率。

离线部署：下载离线镜像包#

在无法访问外网的环境中，可以先使用HubProxy下载离线镜像包，然后传输到目标环境进行部署。

AI训练：加速模型下载#

训练大模型时，从Hugging Face下载模型文件经常失败。使用HubProxy加速下载，提高下载成功率。

个人开发者：摆脱加速依赖#

作为个人开发者，不再依赖不稳定的免费第三方加速服务，自己部署一个稳定可靠的加速服务。

📝 我的使用感受#

部署HubProxy后，我再也没有遇到过Docker镜像拉取失败的问题了！以前拉取ghcr.io的镜像经常超时，现在秒速完成。GitHub Release下载也快了很多，特别是下载大文件的时候。

最让我惊喜的是离线镜像下载功能，有时候需要在没有外网的环境部署，这个功能简直太实用了！

配置也很简单，一行Docker命令就能启动，默认配置已经很好用了。如果需要自定义，修改config.toml文件即可。

🎯 总结#

HubProxy是一款非常强大的加速代理服务，完全免费、开源。Docker镜像加速、GitHub文件加速、离线镜像下载、AI模型加速…一个服务搞定所有加速需求！如果你是开发人员、运维人员，或者经常遇到镜像拉取慢、文件下载失败的问题，HubProxy绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/sky22333/hubproxy

Docker镜像: ghcr.io/sky22333/hubproxy

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！OmniRoute：一个端点连接237个AI服务商，每月16亿免费Token！

2026-07-08T00:00:00.000Z

朋友们！AI接口总断连？Token不够用？#

做开发的朋友应该都遇到过这种情况：用着用着AI接口突然断了，要么是额度用完了，要么是服务商限流了。换一个服务商又要重新配置，太麻烦了！好家伙，今天给大家介绍一个神器——OmniRoute！一个端点连接237个AI服务商，自动故障转移，每月16亿免费Token，让你再也不用担心接口断连！

📚 项目介绍#

OmniRoute 是一个开源的AI网关项目，一个端点就能连接237个AI服务商（90+免费），支持自动故障转移、Token压缩、成本优化等功能。它就像一个AI接口的路由器，智能选择最合适的服务商，让你的AI应用永不中断！最重要的是，它兼容Claude Code、Cursor、Copilot等所有编码工具，只需配置一次就能全部使用！

核心特点#

🌐 237个AI服务商：一个端点连接OpenAI、Claude、Gemini、DeepSeek、阿里Qwen等237个服务商
🆓 90+免费服务商：11个永久免费（Kiro、Qoder、Pollinations、LongCat等），无需信用卡
🔄 自动故障转移：4层自动降级（订阅→API→便宜→免费），毫秒级切换，零停机
🗜️ Token压缩：RTK + Caveman压缩技术，节省15-95%的Token（工具密集型会话平均节省89%）
💰 成本优化路由：自动选择最便宜的可用模型，最大化订阅额度
🔌 兼容所有工具：Claude Code、Cursor、Cline、Copilot、Antigravity等16+编码工具
🔒 生产级安全：熔断机制、TLS隐身、MCP（87个工具）、A2A、内存管理、防护栏、评估
📊 免费Token仪表盘：实时显示每月约16亿免费Token的使用情况
🌍 全球访问：3层代理 + TLS指纹隐身，任何国家都能使用AI
📱 多种部署方式：Docker、Docker Compose、Electron桌面应用、Fly.io

🚀 使用指南#

安装方式#

方式一：Docker快速启动

Terminal window

1
docker run -p 20128:20128 diegosouzapw/omniroute:latest

方式二：Electron桌面应用

从GitHub Releases页面下载桌面客户端，双击安装即可使用。

配置方式#

在 .env 文件中配置服务商API密钥：

Terminal window

1
# OpenAI
2
OPENAI_API_KEY=your-key
3

4
# Claude
5
ANTHROPIC_API_KEY=your-key
6

7
# Gemini
8
GEMINI_API_KEY=your-key
9

10
# DeepSeek
11
DEEPSEEK_API_KEY=your-key
12

13
# 更多服务商...

使用方式#

配置完成后，所有AI工具只需指向一个端点：

Terminal window

1
# OpenAI兼容端点
2
http://localhost:20128/v1
3

4
# Claude兼容端点
5
http://localhost:20128/v1/claude

在IDE或CLI中配置这个端点，所有编码工具都能使用！

路由策略#

OmniRoute支持17种路由策略：

成本优先：自动选择最便宜的可用模型
性能优先：选择响应最快的模型
质量优先：选择最高质量的模型
自动故障转移：依次尝试订阅→API→便宜→免费
轮询：按顺序轮询所有可用服务商

💡 使用场景#

AI应用开发者：永不中断的AI服务#

作为AI应用开发者，你再也不用担心某个服务商限流或断连。OmniRoute会自动切换到其他可用服务商，保证你的应用永不中断。同时，成本优化路由会选择最便宜的模型，大幅降低API费用。

编码工具用户：一次配置，全部使用#

如果你同时使用Claude Code、Cursor、Copilot等多种编码工具，每个工具都需要配置不同的API密钥，非常麻烦。现在只需配置OmniRoute的端点，所有工具都能使用，还能享受自动故障转移和Token压缩。

AI研究人员：访问所有模型#

作为AI研究人员，你需要对比不同模型的效果。OmniRoute让你通过一个端点访问237个服务商的500+模型，无需分别注册和配置。

团队协作：统一管理AI资源#

在团队中，不同成员可能使用不同的AI服务商。OmniRoute提供统一的管理界面，管理员可以集中管理所有API密钥，设置访问权限，追踪Token使用情况。

全球用户：突破地域限制#

如果你所在的国家无法访问某些AI服务商，OmniRoute的3层代理和TLS指纹隐身功能可以帮你突破限制，从任何地方使用AI服务。

📝 我的使用感受#

以前用OpenAI的时候，经常遇到限流的问题，代码写到一半突然断了，特别烦人。现在OmniRoute会自动切换到其他服务商，几乎感觉不到中断！

而且Token压缩也很实用。我用Claude Code写代码的时候，工具输出的git diff、grep结果、日志等内容特别多，特别费Token。现在经过压缩后，平均能节省89%的Token，API费用大幅降低！

唯一需要注意的是，首次配置需要添加一些服务商的API密钥，但配置一次后就不用管了，非常省心。

🎯 总结#

OmniRoute是一款非常强大的AI网关项目，完全免费、开源。237个AI服务商、自动故障转移、Token压缩、成本优化…功能强大到让你挑花眼。如果你是AI应用开发者、编码工具用户、AI研究人员，或者经常遇到AI接口断连的问题，OmniRoute绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/diegosouzapw/OmniRoute

官方网站: https://omniroute.online/

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

网页测试太难？微软Playwright：一套API搞定三大浏览器，自动等待超智能

2026-07-08T00:00:00.000Z

朋友们！网页测试和自动化太难了？#

做前端开发的朋友应该都遇到过这种情况：每次改完代码，都要手动打开浏览器测试各种场景，费时费力。或者想写个脚本自动化处理网页内容，结果被各种等待和定位问题折腾得死去活来。好家伙，今天给大家介绍一个神器——Playwright！微软出品，支持三大浏览器，自动等待、智能定位，让网页测试和自动化变得超级简单！

📚 项目介绍#

Playwright 是微软开发的一款开源网页自动化框架，支持 Chromium、Firefox、WebKit 三大浏览器，只需一套 API 就能在所有浏览器上运行。它不仅可以用来做端到端测试，还能用来做网页自动化、爬虫、PDF生成等。最重要的是，它支持 AI 代理集成，让 AI 可以直接控制浏览器！

核心特点#

🎭 跨浏览器支持：一套API支持Chromium、Firefox、WebKit，真正的跨浏览器测试
⏱️ 自动等待：不需要写 sleep()，自动等待元素可交互后再操作
🎯 智能定位器：支持按角色、标签、占位符、测试ID等多种方式定位元素
🔒 测试隔离：每个测试在独立的浏览器上下文运行，互不干扰
📋 追踪功能：测试失败时自动生成追踪文件，包含完整的执行记录
🚀 并行执行：默认并行运行所有测试，大幅提升效率
🤖 AI代理集成：支持MCP协议和CLI工具，AI可以直接控制浏览器
📱 移动端模拟：支持模拟各种移动设备，测试响应式网站
🌐 网络拦截：可以拦截和修改网络请求，方便测试各种场景
📝 多语言支持：支持TypeScript、Python、.NET、Java四种语言

🚀 使用指南#

安装方式#

方式一：Playwright Test（端到端测试）

Terminal window

1
# 初始化项目
2
npm init playwright@latest
3

4
# 安装依赖
5
npm i -D @playwright/test
6
npx playwright install

方式二：Playwright Library（自动化脚本）

Terminal window

1
npm i playwright
2
npx playwright install

方式三：Playwright MCP（AI代理）

Terminal window

1
# 在MCP配置中添加
2
npx @playwright/mcp@latest

方式四：Playwright CLI（命令行工具）

Terminal window

1
npm install -g @playwright/cli@latest

核心功能使用#

1. 编写端到端测试#

1
import { test, expect } from '@playwright/test';
2

3
test('has title', async ({ page }) => {
4
  await page.goto('https://playwright.dev/');
5
  await expect(page).toHaveTitle(/Playwright/);
6
});
7

8
test('get started link', async ({ page }) => {
9
  await page.goto('https://playwright.dev/');
10
  await page.getByRole('link', { name: 'Get started' }).click();
11
  await expect(page.getByRole('heading', { name: 'Installation' })).toBeVisible();
12
});

2. 运行测试#

Terminal window

1
npx playwright test

3. 自动生成测试代码#

Terminal window

1
npx playwright codegen https://example.com

4. 网页自动化脚本#

1
import { chromium } from 'playwright';
2

3
const browser = await chromium.launch();
4
const page = await browser.newPage();
5

6
// 截图
7
await page.goto('https://playwright.dev/');
8
await page.screenshot({ path: 'screenshot.png' });
9

10
// 生成PDF
11
await page.pdf({ path: 'page.pdf', format: 'A4' });
12

13
// 模拟移动端
14
const context = await browser.newContext({
15
  viewport: { width: 375, height: 812 }
16
});
17

18
await browser.close();

展开收起

5. 网络拦截#

1
await page.route('**/*.{png,jpg,jpeg}', route => route.abort());
2
await page.goto('https://playwright.dev/');

6. 保存登录状态#

1
// 登录后保存状态
2
await page.context().storageState({ path: 'auth.json' });
3

4
// 在其他测试中复用
5
test.use({ storageState: 'auth.json' });

💡 使用场景#

端到端测试：覆盖全流程用户操作#

无论是电商网站的登录注册、商品搜索、购物车结算、支付下单，还是企业系统的表单填写、权限验证、文件上传下载、多标签页切换，Playwright都能像真人一样完整模拟用户操作流程。自动等待元素加载、智能定位、测试隔离等特性，让测试代码简洁可靠，真正实现全链路自动化测试。

AI Agent 浏览器操控：让AI直接”看”网页#

作为Claude Code、Cursor、Gemini等主流AI编程工具的默认浏览器后端，Playwright通过MCP协议让大模型直接操控网页。AI不再需要通过截图识别页面内容，而是通过结构化的可访问性树直接获取页面信息，精准点击按钮、填写表单、浏览内容，Token消耗极低，操作更加准确高效。

网页数据采集：轻松突破各种限制#

对于JavaScript渲染的SPA页面、需要无限滚动加载的列表、带有动态参数签名的接口，传统爬虫往往束手无策。而Playwright使用真实浏览器渲染页面，自带浏览器指纹，能轻松绕过大部分反爬机制。配合登录态复用、网络拦截等功能，可批量完成数据采集、截图归档、PDF生成等任务。

视觉回归测试：自动捕捉UI变化#

在CI/CD流程中集成Playwright的视觉对比功能，每次代码提交后自动对比页面截图。无论是像素级别的细微差异，还是整体布局的变化，都能被精确捕捉，确保UI始终符合设计规范，避免意外的视觉回归问题。

性能分析：深度洞察前端瓶颈#

通过Playwright的追踪功能，可以获取完整的网络请求瀑布图、Core Web Vitals指标、长任务耗时、内存占用等详细数据。这些数据现成可用，无需额外配置，帮助开发者快速定位性能瓶颈，进行前端性能优化。

📝 我的使用感受#

让我惊喜的是它的自动等待功能。以前用Selenium的时候，经常遇到元素还没加载出来就执行操作的问题，需要手动加各种等待。现在Playwright会自动等待元素可交互，代码简洁多了！

而且智能定位器也很好用。page.getByRole('button', { name: 'Submit' }) 这种方式比用CSS选择器更稳定，页面结构变化时不容易失效。

另外，追踪功能在调试测试失败时非常有用。测试失败后生成的trace文件，可以看到每一步的操作、DOM快照、网络请求，调试起来事半功倍。

唯一需要注意的是，Playwright的文档虽然很详细，但内容比较多，需要花点时间学习。不过一旦掌握，效率提升非常明显。

🎯 总结#

Playwright是一款非常强大的网页自动化框架，微软出品、完全免费、开源。跨浏览器支持、自动等待、智能定位器、测试隔离、AI代理集成…功能强大到让你挑花眼。如果你是前端开发者、测试工程师，或者需要做网页自动化，Playwright绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/microsoft/playwright

官方文档: https://playwright.dev/

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

喜欢的博主突然下架视频？这个开源工具，一键备份所有精彩内容！

2026-07-06T00:00:00.000Z

朋友们！喜欢的博主突然下架视频怎么办？#

你有没有遇到过这种情况：关注了一个特别喜欢的博主，他的视频质量超高，你想着有空再慢慢看。结果某天打开抖音，发现他的视频全部下架了，或者账号直接注销了！好家伙，那些精彩内容再也找不到了，悔得肠子都青了！

今天给大家介绍一个神器——douyin-downloader！它能一键备份喜欢的博主的所有视频，再也不用担心视频下架了！

📚 项目介绍#

douyin-downloader 是一个完全免费开源的抖音视频下载工具，支持Windows、macOS、Linux三大平台。它就像一个视频备份工厂，从单个视频到整个用户主页，从直播录制到评论采集，全都能搞定！最重要的是，它支持无水印下载和最高质量选择，备份的视频和原版一样清晰！

核心特点#

🎥 单个视频下载：支持抖音视频链接、图片笔记、合集、音乐下载
👤 用户主页批量下载：一键下载博主的所有作品、喜欢的视频、合集、音乐
❤️ 收藏备份：登录后备份你的收藏夹内容
📺 直播录制：支持录制抖音直播，自动保存为FLV/HLS格式
💬 评论采集：下载视频的评论和回复，保存为JSON文件
🔍 热门搜索：获取抖音热搜榜，关键词搜索视频
🚀 无水印优先：自动选择无水印视频源
🎯 最高质量：自动选择最高码率的视频和图片
📊 去重机制：SQLite数据库+本地文件双重去重，避免重复下载
🔄 增量下载：只下载新增内容，适合定期备份
⚡ REST API：支持作为服务运行，方便集成到其他系统
🔔 通知推送：下载完成后推送通知到Bark、Telegram、企业微信等

🚀 使用指南#

安装方式#

方式一：下载桌面客户端（推荐）

项目提供了桌面客户端 Douzy，直接下载即可使用，无需配置Python环境：

访问 GitHub Releases 页面：https://github.com/jiji262/douyin-downloader/releases
根据系统选择对应的安装包（Windows/macOS/Linux）
下载并安装，双击打开即可使用

💡 提示：桌面客户端支持粘贴链接开始下载、同步关注列表、可视化追踪下载进度

方式二：源码安装（开发者）

Terminal window

1
# 克隆项目
2
git clone https://github.com/jiji262/douyin-downloader.git
3
cd douyin-downloader
4

5
# 安装依赖
6
pip install -r requirements.txt
7

8
# 安装浏览器依赖（用于浏览器回退）
9
pip install playwright
10
python -m playwright install chromium

方式三：Docker部署

Terminal window

1
docker build -t douyin-downloader .
2
docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader

获取Cookie#

Terminal window

1
python -m tools.cookie_fetcher --config config.yml

运行后会自动打开浏览器，登录抖音后按回车键，Cookie会自动保存到配置文件中。

配置文件示例#

1
link:
2
  - https://www.douyin.com/user/MS4wLjABAAAAxxxx
3
mode:
4
  - post
5
number:
6
  post: 0  # 0表示下载全部
7
thread: 5
8
retry_times: 3
9
database: true
10
database_path: dy_downloader.db
11
cookies:
12
  ttwid: YOUR_TTWID
13
  odin_tt: YOUR_ODIN_TT

核心功能使用#

1. 下载单个视频#

Terminal window

1
python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

2. 批量下载博主所有作品#

Terminal window

1
python run.py -c config.yml \
2
  -u "https://www.douyin.com/user/MS4wLjABAAAAxxxx" \
3
  -m post \
4
  -n 0  # 0表示下载全部

3. 下载博主的喜欢列表#

Terminal window

1
python run.py -c config.yml \
2
  -u "https://www.douyin.com/user/MS4wLjABAAAAxxxx" \
3
  -m like \
4
  -n 0

4. 备份收藏夹#

Terminal window

1
python run.py -c config.yml \
2
  -u "https://www.douyin.com/user/self?showTab=favorite_collection" \
3
  -m collect \
4
  -n 0

5. 录制直播#

Terminal window

1
python run.py -c config.yml \
2
  -u "https://live.douyin.com/123456789"

6. 增量下载（只下载新增内容）#

1
# 在config.yml中添加
2
increase:
3
  post: true
4
  like: true
5
database: true

📊 对比其他方案#

功能	douyin-downloader	在线下载网站	抖音自带保存	其他下载工具
免费	✅	✅	✅	部分
无水印下载	✅	✅	❌	部分
批量下载	✅	❌	❌	部分
直播录制	✅	❌	❌	❌
评论采集	✅	❌	❌	❌
增量下载	✅	❌	❌	❌
去重机制	✅	❌	❌	❌
REST API	✅	❌	❌	❌
开源	✅	❌	❌	❌

💡 使用场景#

场景一：备份喜欢的博主内容#

关注了一个优质博主，担心他的视频下架？一键批量下载他的所有作品，永久保存。

场景二：备份自己的收藏夹#

收藏了很多精彩视频，怕抖音清理或者自己误删？定期备份收藏夹内容。

场景三：直播录制#

喜欢的主播开播了，没时间看？用录制功能自动保存直播内容，有空再看。

场景四：数据分析#

想研究某个领域的热门视频？用关键词搜索和评论采集功能，获取数据进行分析。

场景五：批量下载合集#

看到一个精彩的视频合集？一键下载整个合集，离线慢慢看。

📝 我的使用感受#

我关注了几个优质博主，设置了增量下载，每天自动运行一次，只下载新增的视频。这样既不会重复下载浪费空间，也不会错过任何新内容。

而且去重机制也很实用。有时候同一个视频会出现在不同的合集中，douyin-downloader会自动跳过已经下载过的视频，非常智能。

唯一需要注意的是，抖音的API可能会有变化，需要定期更新Cookie。不过项目更新很及时，基本不会有太大问题。

🎯 总结#

douyin-downloader是一款非常强大的抖音视频下载工具，完全免费、开源。批量下载、增量更新、去重机制、直播录制、评论采集…功能强大到让你挑花眼。如果你经常刷抖音，又担心喜欢的内容下架，douyin-downloader绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/jiji262/douyin-downloader

下载地址: https://github.com/jiji262/douyin-downloader/releases

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

做自媒体的看过来！这个工具一键完成视频翻译、字幕生成、AI配音

2026-07-02T00:00:00.000Z

朋友们！视频翻译太麻烦？#

做自媒体的朋友应该都遇到过这种情况：想把外国视频翻译成中文，或者给视频配音、加字幕，要么收费贵，要么效果差。好家伙，今天给大家介绍一个开源神器——pyVideoTrans！它能一键完成语音识别→字幕翻译→AI配音→视频合成，全程自动化，效果还特别好！

📚 项目介绍#

pyVideoTrans 是一个完全免费开源的AI视频翻译工具，支持Windows、macOS、Linux三大平台。它就像一个视频翻译工厂，从语音识别到字幕翻译，再到AI配音和视频合成，一站式搞定！最重要的是，它支持多种本地模型，没有网络也能工作！

核心特点#

🎥 全自动视频翻译：一键完成语音识别→字幕翻译→AI配音→视频合成
🎙️ 音频转录：批量将音频/视频转换为SRT字幕，支持角色区分（Speaker Diarization）
🗣️ 多角色AI配音：为不同说话者分配不同的AI语音
🧬 语音克隆：集成F5-TTS、CosyVoice、GPT-SoVITS等模型，零样本克隆语音
🧠 强大模型支持：
- ASR：Faster-Whisper（本地）、OpenAI Whisper、阿里Qwen、火山引擎、Azure、Google等
- 翻译：DeepSeek、ChatGPT、Claude、Gemini、MiniMax、Ollama（本地）等
- TTS：Edge-TTS（免费）、OpenAI、Azure、ChatTTS、F5-TTS、CosyVoice等
🖥️ 交互式编辑：支持在识别、翻译、配音各阶段暂停手动校对，确保准确性
🛠️ 实用工具包：人声分离、视频/字幕合并、音视频对齐、字幕匹配等辅助工具
💻 命令行支持：支持无界面运行，方便服务器部署或批量处理

🚀 使用指南#

安装方式#

方式一：Windows一键运行（推荐）

从GitHub Releases页面下载最新预打包版本
解压到无空格无中文的路径（如 D:\pyVideoTrans）
双击 sp.exe 启动

💡 提示：如需GPU加速，需安装 CUDA 12.8 和 cuDNN 9.11

方式二：源码部署（macOS/Linux/Windows开发者）

Terminal window

1
# 安装uv包管理工具
2
curl -LsSf https://astral.sh/uv/install.sh | sh
3

4
# 克隆项目
5
git clone https://github.com/jianchang512/pyvideotrans.git
6
cd pyvideotrans
7

8
# 安装依赖
9
uv sync
10

11
# 启动GUI
12
uv run sp.py

核心功能使用#

1. 全自动视频翻译#

导入视频文件
设置源语言和目标语言
选择ASR、翻译、TTS模型
点击开始，自动完成语音识别→字幕翻译→AI配音→视频合成

2. 音频转字幕#

导入音频/视频文件
选择ASR模型（推荐Faster-Whisper）
点击开始，生成SRT字幕文件
支持角色区分（Speaker Diarization）

3. 多角色配音#

在字幕编辑界面为不同说话者分配不同角色
为每个角色选择不同的TTS语音
点击配音，生成多角色配音的视频

4. 语音克隆#

导入参考音频（目标人物的语音）
选择语音克隆模型（F5-TTS、CosyVoice、GPT-SoVITS）
生成与参考语音相似的配音

5. 命令行批量处理#

Terminal window

1
# 视频翻译
2
uv run cli.py --task vtv --name "./video.mp4" --source_language_code zh --target_language_code en
3

4
# 音频转字幕
5
uv run cli.py --task stt --name "./audio.wav" --model_name large-v3

📝 我的使用感受#

用了pyVideoTrans一段时间，最让我惊喜的是它的全自动视频翻译功能。以前翻译一个视频，要先用Whisper转字幕，再手动翻译，然后找配音软件，最后用PR合成，整个流程要花好几个小时。现在pyVideoTrans一键搞定，效率直接提升10倍！

而且语音克隆功能也很强大。我用一段1分钟的参考音频，就能克隆出和目标人物非常相似的声音，配音效果几乎可以以假乱真。

唯一需要注意的是，本地模型需要一定的GPU资源。如果没有高端显卡，可以选择在线API，效果同样很好。

🎯 总结#

pyVideoTrans是一款非常强大的AI视频翻译工具，完全免费、开源。全自动视频翻译、多角色配音、语音克隆、批量处理…功能强大到让你挑花眼。如果你是自媒体创作者、视频翻译工作者，或者经常需要处理视频字幕和配音，pyVideoTrans绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/jianchang512/pyvideotrans

官方文档: https://pyvideotrans.com/

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

【OCR工具推荐其二】Pot：翻译+OCR二合一神器，划词翻译、截图识别全覆盖

2026-06-25T00:00:00.000Z

朋友们！还在为截图文字提取发愁吗？#

在上一篇【其一】中，我给大家介绍了 Umi-OCR，它非常适合批量处理图片和 PDF 识别。不过今天要给大家介绍另一个选择——Pot（派了个萌的翻译器）！

它不仅支持截图 OCR，还支持划词翻译、截图翻译，简直是翻译和 OCR 的二合一神器！而且更重要的是，Pot 支持离线 OCR 引擎，不用联网也能识别图片文字！

如果你觉得 Umi-OCR 用起来不错，那 Pot 绝对值得一试。这两个工具配合使用：日常截图 OCR 和翻译用 Pot，需要批量处理或 PDF 识别时用 Umi-OCR，效率直接翻倍！

📚 项目介绍#

Pot 是一个完全免费开源的跨平台划词翻译和 OCR 软件，支持 Windows、macOS、Linux 三大平台。它最大的特点是翻译+OCR 二合一，一个软件搞定两种需求，再也不用在多个软件之间来回切换了。

核心特点#

📷 截图 OCR 识别：截图框选即可识别文字，支持多种离线 OCR 引擎
🌐 划词翻译：选中文字即翻译，支持 50+ 翻译接口
🖼️ 截图翻译：截图后自动识别文字并翻译
🔊 语音合成：支持 TTS，看单词还能听发音
📖 生词本功能：支持导出到 Anki、欧路词典、有道、扇贝
🔌 插件系统：丰富的插件生态，可扩展更多功能
💻 全平台支持：Windows、macOS、Linux 统统支持
🆓 完全免费：开源免费，没有广告，没有会员

支持的 OCR 接口#

Pot 支持多种 OCR 接口，既有系统自带的离线引擎，也有第三方在线服务：

系统自带离线 OCR（推荐）：

Windows：Windows.Media.OCR（系统自带，无需额外安装）
macOS：Apple Vision Framework（系统自带，无需额外安装）
Linux：Tesseract OCR（需单独安装）

跨平台离线 OCR 插件：

Rapid OCR：高性能离线 OCR 引擎，识别速度快，准确率高
Paddle OCR：轻量级离线 OCR 引擎，支持多语言识别

在线 OCR 服务：

百度 OCR：国内主流 OCR 服务，识别准确率高
腾讯 OCR：腾讯云提供的 OCR 服务
火山 OCR：字节跳动的 OCR 服务
讯飞 OCR：科大讯飞的 OCR 服务
Simple LaTeX：专门用于数学公式识别

💡 使用建议：日常使用推荐配置 Rapid OCR 或 Paddle OCR 插件，识别速度快且完全离线，不用担心网络问题！

支持的翻译接口（50+）#

AI大模型接口：

OpenAI（GPT系列）
智谱 AI（GLM系列）
Google Gemini
Ollama（离线可用）

国内翻译接口：

百度翻译、腾讯翻译君、阿里翻译
彩云小译、火山翻译、有道翻译
腾讯交互翻译、小牛翻译

国际翻译接口：

DeepL、Google翻译、Bing翻译
Yandex、Lingva

💻 安装指南#

Windows 系统#

方式一：Winget 安装（推荐）

Terminal window

1
winget install Pylogmon.pot

方式二：手动安装

进入 Release 页面下载最新安装包
下载对应的 pot_{version}_x64-setup.exe
双击安装即可

注意：如果启动后没有界面，请确保已安装 WebView2，运行库。

macOS 系统#

方式一：Homebrew 安装（推荐）

Terminal window

1
# 添加 tap
2
brew tap pot-app/homebrew-tap
3
# 安装 pot
4
brew install --cask pot
5
# 更新
6
brew upgrade --cask pot

方式二：手动安装

从 Release 页面下载 pot_{version}_aarch64.dmg（M1）或 pot_{version}_x64.dmg（Intel）
双击后将 pot 拖入 Applications 文件夹即可

Linux 系统#

Debian/Ubuntu：

Terminal window

1
sudo apt-get install ./pot_{version}_amd64.deb

Arch/Manjaro：

Terminal window

1
yay -S pot-translation

Flatpak：

Terminal window

1
flatpak install flathub com.pot_app.pot

🚀 使用指南#

基础配置#

首次启动：安装完成后打开 Pot，进行基础配置
添加 OCR 接口：设置 -> 服务设置 -> 添加识别服务（推荐配置 Rapid OCR 或 Paddle OCR）
添加翻译接口：设置 -> 服务设置 -> 添加翻译服务
配置快捷键：设置 -> 快捷键，设置截图 OCR、划词翻译和截图翻译的快捷键

核心功能使用#

1. 截图 OCR 识别（最常用）#

按下截图 OCR 快捷键
框选需要识别的区域
自动识别并显示文字结果
可复制或发送到翻译

2. 截图翻译#

按下截图翻译快捷键
框选需要翻译的区域
自动识别文字并翻译

3. 划词翻译#

选中需要翻译的文本
按下划词翻译快捷键
弹出翻译窗口，显示翻译结果

4. 剪切板监听模式#

点击翻译面板左上角图标启动剪切板监听
复制文字即可自动翻译

OCR 接口配置#

Pot 支持多种 OCR 接口：

离线 OCR（推荐）：

Windows：系统自带 OCR（Windows.Media.OCR）
macOS：Apple Vision Framework
Linux：Tesseract OCR
Rapid OCR（跨平台离线插件）
Paddle OCR（跨平台离线插件）

在线 OCR：

百度 OCR、腾讯 OCR、火山 OCR
讯飞 OCR、Simple LaTeX（公式识别）

生词本功能#

Pot 支持将单词导出到多个生词本应用：

Anki：著名的间隔重复记忆软件
欧路词典：专业的词典软件
有道词典：国内知名词典
扇贝：支持扇贝单词

🔌 插件系统#

Pot 的插件系统非常强大，可以扩展更多功能：

常用插件#

ECDICT 插件：离线英英词典
Tatoeba 插件：例句查询
Lingva 插件：Privacy-respecting翻译
Rapid OCR 插件：高性能离线OCR
Paddle OCR 插件：轻量级离线OCR

安装插件#

访问 Plugin List 查找需要的插件
下载 .potext 文件
在偏好设置 -> 服务设置 -> 添加外部插件 -> 安装外部插件
选择下载的 .potext 文件即可

📊 对比其他方案#

功能	Pot	Umi-OCR	天若OCR	白描
免费	✅	✅	✅	付费
截图OCR	✅	✅	✅	✅
划词翻译	✅	❌	❌	❌
离线OCR	✅	✅	✅	❌
批量OCR	❌	✅	❌	✅
PDF识别	❌	✅	❌	✅
翻译功能	✅ 50+接口	❌	❌	❌
跨平台	✅ Win/Mac/Linux	✅ Win/Linux	✅ Win	✅

💡 小结：如果你主要用 OCR 功能，Umi-OCR 更适合批量处理；如果你需要 OCR+翻译二合一，Pot 是更好的选择！

💡 使用场景#

场景一：截图识别外语文档#

遇到 PDF 或者图片中的外语文本，直接截图识别，还能一键翻译。

场景二：阅读外文网页#

浏览外文网站时，遇到不懂的单词，划词翻译，还能保存到生词本复习。

场景三：截图翻译外国网站#

遇到全是外语的网站，截图翻译，秒懂内容。

场景四：离线环境 OCR#

配置 Rapid OCR 或 Paddle OCR 引擎，没有网络也能识别图片文字。

场景五：多翻译接口切换#

一个翻译接口被限速了？没关系，换一个继续用，再也不用担心翻译中断。

📝 我的使用感受#

如果你用过 Umi-OCR，可能会觉得 Pot 的 OCR 功能没有它强大（比如不支持批量处理和 PDF 识别）。但 Pot 的优势在于翻译功能，划词翻译、截图翻译、多接口并行…这些 Umi-OCR 都没有。所以我的建议是：两个工具配合使用，日常截图 OCR 用 Pot，需要批量处理或 PDF 识别时用 Umi-OCR，效率拉满！

🎯 总结#

Pot 是一款翻译+OCR 二合一的开源工具，完全免费、开源、跨平台。截图 OCR 识别、划词翻译、截图翻译、离线引擎、多翻译接口…功能丰富到让你挑花眼。如果你需要一款既能 OCR 又能翻译的工具，Pot 绝对值得一试！配合 Umi-OCR 使用，OCR 需求全搞定！

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

【OCR工具推荐其一】Umi-OCR：图片文字识别，截图、批量、PDF全搞定

2026-06-25T00:00:00.000Z

朋友们！遇到图片里的文字想复制？#

你是不是经常遇到这些困扰：

图片文字无法复制：看到截图里的重要文字，却无法直接复制
在线OCR不安全：上传敏感图片到第三方网站，担心数据泄露
批量处理太麻烦：需要识别几十张图片，一张一张处理太累
PDF扫描件无法搜索：扫描版PDF无法检索内容，翻页找信息太耗时
公式无法提取：文档里的数学公式，想复制出来却无能为力
需要网络才能用：离线环境下无法使用OCR工具

今天我要给大家分享一个 GitHub 上的宝藏项目——Umi-OCR！这是一款完全免费开源的离线OCR软件，支持截图识别、批量OCR、PDF识别、二维码、公式识别，解压即用，无需网络！

✨ 什么是 Umi-OCR？#

Umi-OCR 是一款免费、开源、可批量的离线OCR软件，适用于 Windows7 x64 和 Linux x64。它内置高效率的离线OCR引擎，支持多种语言识别，无需网络即可运行。

核心特点：

🆓 完全免费：所有代码开源，无任何隐藏费用
🔌 离线运行：无需网络，所有识别在本地完成
📦 解压即用：无需安装，解压后即可使用
🚀 高效识别：内置多种OCR引擎，识别速度快、准确率高
✂️ 截图OCR：快捷键唤起截图，一键识别图片中的文字
📷 批量OCR：支持批量导入图片，一次性识别几百张
📄 PDF识别：从PDF扫描件中提取文本，生成可搜索PDF
📐 公式识别：支持数学公式识别
📱 二维码：支持扫码和生成二维码
🖥️ 命令行调用：支持脚本自动化处理
🌐 HTTP接口：支持外部程序调用

🎯 核心功能#

1. 截图OCR#

截图OCR是Umi-OCR最常用的功能，只需按下快捷键即可唤起截图，识别图中的文字：

1
- 快捷键唤起截图（默认Ctrl+Shift+A）
2
- 左侧图片预览栏，可直接划选复制
3
- 右侧识别记录栏，可编辑文字，支持多选复制
4
- 支持粘贴图片进行识别
5
- 支持公式识别

文本后处理：支持多种排版解析方案，自动识别多栏布局，按正确顺序输出文字：

多栏-按自然段换行
多栏-总是换行
多栏-无换行
单栏-按自然段换行
单栏-保留缩进（适合代码截图）
不做处理

2. 批量OCR#

批量OCR功能可以一次性导入大量图片进行识别：

1
- 支持格式：jpg, jpeg, png, webp, bmp, tif等
2
- 输出格式：txt, jsonl, md, csv(Excel)
3
- 支持文本后处理，整理排版和顺序
4
- 无数量上限，可一次性导入几百张
5
- 支持任务完成后自动关机/待机
6
- 支持处理超大长图

忽略区域：可以排除图片中不想要的文字，比如水印、LOGO等：

在批量识别页右栏设置中进入忽略区域编辑器
按住右键绘制矩形框，框内的文字将被忽略
适合处理带有水印的批量图片

3. 文档识别#

文档识别功能可以处理PDF等文档格式：

1
- 支持格式：pdf, xps, epub, mobi, fb2, cbz
2
- 对扫描件进行OCR，提取原有文本
3
- 可输出为双层可搜索PDF
4
- 支持设定忽略区域，排除页眉页脚
5
- 支持任务完成后自动关机/休眠

4. 二维码#

二维码功能支持扫码和生成：

1
扫码：
2
- 截图/粘贴/拖入图片，读取二维码、条形码
3
- 支持一图多码
4
- 支持19种协议（QRCode、DataMatrix、PDF417等）
5

6
生成码：
7
- 输入文本，生成二维码图片
8
- 支持19种协议和纠错等级

5. 全局设置#

全局设置可以调整软件的各种参数：

1
- 一键添加快捷方式或设置开机自启
2
- 更改界面语言（支持繁中、英语、日语等）
3
- 切换界面主题（多个亮/暗主题）
4
- 调整界面文字大小和字体
5
- 切换OCR插件
6
- 调整渲染器（解决截屏闪烁、UI错位问题）

🚀 安装方式#

方式一：下载压缩包（推荐）#

访问 GitHub 发布页面：https://github.com/hiroi-sora/Umi-OCR/releases/latest
下载 .7z 压缩包或 .7z.exe 自解压包
解压后点击 Umi-OCR.exe 即可启动

国内下载地址（蓝奏云，免注册/无限速）： https://hiroi-sora.lanzoul.com/s/umi-ocr

方式二：Scoop 安装（Windows）#

Terminal window

1
# 添加 extras 桶
2
scoop bucket add extras
3

4
# 安装 Umi-OCR（Rapid-OCR引擎，兼容性好）
5
scoop install extras/umi-ocr
6

7
# 或安装 Paddle-OCR 引擎版本（速度稍快）
8
scoop install extras/umi-ocr-paddle

方式三：Linux 安装#

Terminal window

1
# 下载压缩包
2
wget https://github.com/hiroi-sora/Umi-OCR/releases/latest/download/Umi-OCR-linux-x64.7z
3

4
# 解压
5
7z x Umi-OCR-linux-x64.7z
6

7
# 运行
8
./Umi-OCR/umi-ocr.sh

📝 使用场景#

场景一：截图识别文字#

1
操作步骤：
2
1. 按下 Ctrl+Shift+A 唤起截图
3
2. 框选需要识别的区域
4
3. 识别结果自动显示在右侧
5
4. 复制识别结果即可
6

7
适用场景：
8
- 复制网页上无法选中的文字
9
- 识别PDF中的文字
10
- 提取截图中的关键信息

场景二：批量处理图片#

1
操作步骤：
2
1. 切换到"批量OCR"标签页
3
2. 导入需要识别的图片
4
3. 设置忽略区域（如有水印）
5
4. 选择输出格式
6
5. 点击开始识别
7

8
适用场景：
9
- 处理大量扫描件
10
- 识别图片库中的文字
11
- 批量提取截图内容

场景三：PDF识别#

1
操作步骤：
2
1. 切换到"文档识别"标签页
3
2. 导入PDF文件
4
3. 设置输出格式（txt或双层PDF）
5
4. 点击开始识别
6

7
适用场景：
8
- 将扫描版PDF转为可搜索PDF
9
- 提取PDF中的文字内容
10
- 批量处理PDF文档

场景四：二维码处理#

1
扫码：
2
1. 切换到"二维码"标签页
3
2. 粘贴或拖入包含二维码的图片
4
3. 自动识别并显示结果
5

6
生成码：
7
1. 切换到"二维码"标签页
8
2. 输入要生成的文本
9
3. 选择协议和纠错等级
10
4. 生成二维码图片
11

12
适用场景：
13
- 识别商品包装上的二维码
14
- 生成分享链接二维码
15
- 批量生成二维码

展开收起

场景五：命令行调用#

Terminal window

1
# 截图识别
2
Umi-OCR.exe --clipboard
3

4
# 识别单张图片
5
Umi-OCR.exe --img "C:\test.png" --out "C:\result.txt"
6

7
# 批量识别
8
Umi-OCR.exe --img "C:\images" --out "C:\result" --format md
9

10
# 识别PDF
11
Umi-OCR.exe --pdf "C:\test.pdf" --out "C:\result.txt"
12

13
# 二维码识别
14
Umi-OCR.exe --qr "C:\qrcode.png"

🌐 HTTP接口调用#

除了命令行，Umi-OCR还支持HTTP接口调用，方便开发者集成到自己的应用中。

启用HTTP服务#

在全局设置页中勾选高级，确保HTTP服务已开启（默认开启）。如果需要允许局域网访问，请将主机切换到任何可用地址。

API调用示例#

图片OCR识别（Base64方式）：

Terminal window

1
curl -X POST http://localhost:10101/api/ocr \
2
  -H "Content-Type: application/json" \
3
  -d '{"image": "base64编码的图片数据"}'

二维码识别：

Terminal window

1
curl -X POST http://localhost:10101/api/qrcode \
2
  -H "Content-Type: application/json" \
3
  -d '{"image": "base64编码的图片数据"}'

PDF文档识别：

Terminal window

1
curl -X POST http://localhost:10101/api/doc \
2
  -H "Content-Type: application/json" \
3
  -d '{"files": ["base64编码的PDF数据"], "outputFormat": "txt"}'

获取OCR参数：

Terminal window

1
curl http://localhost:10101/api/ocr/get_options

注意事项#

关闭软件时，如果仍有用户未断开HTTP连接，可能导致关闭不完全，需进任务管理器强制结束进程
并发支持较差，尽量不要并发调用
长时间大批量连续调用时，可能出现连接拒绝报错，重新发起请求即可

📊 对比其他方案#

方案	离线	免费	批量处理	PDF识别	二维码	公式识别	命令行
Umi-OCR	✅	✅	✅	✅	✅	✅	✅
在线OCR工具	❌	✅/付费	❌	✅	❌	❌	❌
天若OCR	✅	✅	❌	❌	❌	❌	❌
白描	❌	付费	✅	✅	✅	❌	❌
Adobe Acrobat	✅	付费	✅	✅	❌	✅	❌

📜 开源协议#

Umi-OCR 采用 Apache-2.0 开源协议，完全免费使用。

📝 总结#

Umi-OCR 是一款功能强大的免费离线OCR软件，特别适合需要处理大量图片文字、PDF扫描件的用户。它支持截图识别、批量OCR、PDF识别、二维码、公式识别等多种功能，所有处理都在本地完成，无需网络，数据安全有保障。无论是学生、上班族还是开发者，都能从中受益。如果你经常需要识别图片中的文字，这个工具绝对值得一试！

🌟 项目资源#

GitHub 地址: https://github.com/hiroi-sora/Umi-OCR

发布页面: https://github.com/hiroi-sora/Umi-OCR/releases/latest

国内下载: https://hiroi-sora.lanzoul.com/s/umi-ocr

插件库: https://github.com/hiroi-sora/Umi-OCR_plugins

命令行手册: https://github.com/hiroi-sora/Umi-OCR/blob/main/docs/README_CLI.md

HTTP接口手册: https://github.com/hiroi-sora/Umi-OCR/blob/main/docs/http/README.md

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你最常用的OCR功能是什么？在使用过程中遇到过什么问题？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

Figma太贵？这个开源设计平台，支持自托管，设计即代码

2026-06-24T00:00:00.000Z

朋友们！设计工具太贵还被绑定？#

你是不是经常遇到这些困扰：

Figma太贵：团队协作需要付费，而且价格越来越高
数据不安全：设计稿存放在第三方云端，担心数据泄露
设计开发脱节：设计师设计的效果，开发还原不出来
无法自托管：想在公司内网部署，却没有合适的方案
设计系统难维护：设计令牌、组件库难以统一管理
AI集成困难：想让AI参与设计流程，却没有合适的接口

今天我要给大家分享一个 GitHub 上的宝藏项目——Penpot！这是一款面向团队的开源设计平台，支持实时协作、设计即代码、设计令牌、MCP服务器，可自建部署，完全免费开源！

✨ 什么是 Penpot？#

Penpot 是一款面向团队的开源设计平台，专为大规模构建数字产品而设计。它的核心优势在于让您完全拥有设计基础设施的所有权，基于开源技术构建，支持自托管部署，让团队完全控制设计环境，满足严格的合规和治理要求。

核心特点：

🔓 开源免费：完全开源，无任何隐藏费用
🏠 支持自托管：可部署在自己的服务器上，数据完全自主可控
🎨 设计即代码：设计以代码形式表达，开发者可以直接理解和使用
🔄 实时协作：多人实时协作设计，支持团队协作
🎯 设计令牌：原生设计令牌支持，确保设计一致性
🔌 MCP服务器：支持设计和代码之间的双向工作流
📡 开放API：强大的开放API和插件系统，支持自动化和AI工作流
📱 响应式设计：支持 CSS Grid 和 Flex Layout，设计响应式界面
🌐 开放标准：支持 SVG、CSS、HTML、JSON 等开放标准

🎯 核心功能#

1. 实时协作设计#

Penpot 支持多人实时协作，团队成员可以同时编辑同一个设计文件：

1
- 多人实时编辑
2
- 实时光标显示
3
- 评论和标注
4
- 版本历史
5
- 设计评审

2. 设计即代码#

Penpot 最大的特色之一就是设计以代码形式表达，这让开发者可以直接理解和使用设计：

1
- 设计以 JSON 格式存储
2
- 支持 SVG、CSS、HTML 导出
3
- Inspect 模式提供即时代码访问
4
- 设计可以直接转换为代码
5
- 开发者可以轻松理解设计意图

3. 设计令牌（Design Tokens）#

原生设计令牌支持，提供设计和开发之间的单一事实来源：

1
- 原生设计令牌支持
2
- 确保设计一致性
3
- 简化设计系统管理
4
- 支持复杂设计系统
5
- 设计和开发共享同一来源

4. MCP 服务器#

MCP（Model Context Protocol）服务器实现设计和代码之间的双向工作流：

1
- 支持设计到代码的转换
2
- 支持代码到设计的更新
3
- AI可以读取和理解设计
4
- 实现自动化工作流
5
- 集成现有工具和系统

5. 响应式设计#

支持 CSS Grid 和 Flex Layout，从一开始就设计出像真实代码一样响应的界面：

1
- CSS Grid 布局支持
2
- Flex Layout 支持
3
- 响应式断点设置
4
- 设计真实的响应式界面
5
- 从设计到代码无缝转换

🚀 部署方式#

方式一：使用 SAAS 版本#

直接访问 https://design.penpot.app，无需部署，立即使用。

方式二：Docker 部署（推荐）#

Terminal window

1
# 创建目录
2
mkdir penpot && cd penpot
3

4
# 创建 docker-compose.yaml
5
curl -o docker-compose.yaml https://raw.githubusercontent.com/penpot/penpot/main/docker/images/docker-compose.yaml
6
# 启动服务
7
docker compose up -d

1
# ============================== Penpot 配置说明 ==============================
2
# 功能开关标识列表（可在PENPOT_FLAGS中按需增删）
3
# demo-users: 内置演示账号
4
# email-verification: 注册邮箱验证
5
# log-emails: 打印邮件日志
6
# log-invitation-tokens: 打印邀请链接Token日志
7
# login-with-github: GitHub第三方登录
8
# login-with-gitlab: GitLab第三方登录
9
# login-with-google: Google第三方登录
10
# login-with-ldap: LDAP登录
11
# login-with-oidc: OIDC统一身份登录
12
# login-with-password: 账号密码登录
13
# prepl-server: 开启调试PREPL服务
14
# registration: 允许自助注册账号
15
# secure-session-cookies: 会话Cookie启用安全加密（公网部署必须开启）
16
# smtp: 启用邮件发送服务
17
# smtp-debug: SMTP通信调试日志
18
# telemetry: 匿名使用数据上报
19
# webhooks: WebHook回调能力
20
# 官方完整配置文档：https://help.penpot.app/technical-guide/configuration/#penpot-configuration
21
# 安全警告：公网对外部署务必删除 disable-secure-session-cookies、disable-email-verification 关闭项
22
# ============================================================================
23

24
# 全局功能开关配置
25
x-flags: &penpot-flags
26
  PENPOT_FLAGS: disable-email-verification enable-smtp enable-prepl-server disable-secure-session-cookies enable-mcp
27

28
# Penpot前端访问公网地址
29
x-uri: &penpot-public-uri
30
  PENPOT_PUBLIC_URI: http://localhost:9001
31

32
# HTTP请求体大小限制（上传大设计文件使用）
33
x-body-size: &penpot-http-body-size
34
  # 最大单请求Body上限
35
  PENPOT_HTTP_SERVER_MAX_BODY_SIZE: 367001600
36
  # 兼容旧版变量（已废弃，仅做向下兼容保留）
37
  PENPOT_HTTP_SERVER_MAX_MULTIPART_BODY_SIZE: 367001600
38

39
# Penpot主密钥，用于会话、邀请链接等子密钥派生
40
# 推荐使用512位Base64随机字符串生成，生成命令：python3 -c "import secrets; print(secrets.token_urlsafe(64))"
41
x-secret-key: &penpot-secret-key
42
  PENPOT_SECRET_KEY: change-this-insecure-key
43

44
# 自定义Docker网络，所有服务互通
45
networks:
46
  penpot:
47

48
# 持久化数据卷
49
volumes:
50
  penpot_postgres_v15:  # PostgreSQL数据库存储卷
51
  penpot_assets:         # 上传素材、设计文件存储卷
52

53
services:
54
  # 前端页面服务，用户访问入口
55
  penpot-frontend:
56
    image: "penpotapp/frontend:${PENPOT_VERSION:-2.16}"
57
    restart: always
58
    ports:
59
      - 9001:8080
60
    volumes:
61
      - penpot_assets:/opt/data/assets
62
    # 依赖服务启动完成后再启动前端
63
    depends_on:
64
      - penpot-backend
65
      - penpot-exporter
66
      - penpot-mcp
67
    networks:
68
      - penpot
69
    environment:
70
      << : [*penpot-flags, *penpot-http-body-size, *penpot-public-uri]
71

72
  # Penpot后端核心业务服务
73
  penpot-backend:
74
    image: "penpotapp/backend:${PENPOT_VERSION:-2.16}"
75
    restart: always
76
    volumes:
77
      - penpot_assets:/opt/data/assets
78
    # 等待数据库、缓存健康就绪再启动
79
    depends_on:
80
      penpot-postgres:
81
        condition: service_healthy
82
      penpot-valkey:
83
        condition: service_healthy
84
    networks:
85
      - penpot
86
    environment:
87
      << : [*penpot-flags, *penpot-public-uri, *penpot-http-body-size, *penpot-secret-key]
88
      # PostgreSQL数据库连接配置
89
      PENPOT_DATABASE_URI: postgresql://penpot-postgres/penpot
90
      PENPOT_DATABASE_USERNAME: penpot
91
      PENPOT_DATABASE_PASSWORD: penpot
92
      # Valkey缓存（原Redis），用于WebSocket实时通知
93
      PENPOT_REDIS_URI: redis://penpot-valkey/0
94
      # 文件存储配置：本地文件系统模式
95
      PENPOT_OBJECTS_STORAGE_BACKEND: fs
96
      PENPOT_OBJECTS_STORAGE_FS_DIRECTORY: /opt/data/assets
97
      # 匿名使用数据上报
98
      PENPOT_TELEMETRY_ENABLED: "true"
99
      PENPOT_TELEMETRY_REFERER: compose
100
      # SMTP邮件发送配置（当前使用内置邮件捕获容器）
101
      PENPOT_SMTP_DEFAULT_FROM: no-reply@example.com
102
      PENPOT_SMTP_DEFAULT_REPLY_TO: no-reply@example.com
103
      PENPOT_SMTP_HOST: penpot-mailcatch
104
      PENPOT_SMTP_PORT: 1025
105
      PENPOT_SMTP_USERNAME:
106
      PENPOT_SMTP_PASSWORD:
107
      PENPOT_SMTP_TLS: "false"
108
      PENPOT_SMTP_SSL: "false"
109

110
  # MCP服务扩展组件
111
  penpot-mcp:
112
    image: "penpotapp/mcp:${PENPOT_VERSION:-2.16}"
113
    restart: always
114
    networks:
115
      - penpot
116

117
  # 图纸导出服务（生成图片/PDF等导出能力）
118
  penpot-exporter:
119
    image: "penpotapp/exporter:${PENPOT_VERSION:-2.16}"
120
    restart: always
121
    depends_on:
122
      penpot-valkey:
123
        condition: service_healthy
124
    networks:
125
      - penpot
126
    environment:
127
      << : [*penpot-secret-key]
128
      # 内部网络访问前端地址，用于渲染导出
129
      PENPOT_PUBLIC_URI: http://penpot-frontend:8080
130
      # 连接Valkey缓存
131
      PENPOT_REDIS_URI: redis://penpot-valkey/0
132

133
  # PostgreSQL 数据库存储业务数据
134
  penpot-postgres:
135
    image: "postgres:15"
136
    restart: always
137
    stop_signal: SIGINT
138
    # 数据库健康检测，等待就绪再提供服务
139
    healthcheck:
140
      test: ["CMD-SHELL", "pg_isready -U penpot"]
141
      interval: 2s
142
      timeout: 10s
143
      retries: 5
144
      start_period: 2s
145
    volumes:
146
      - penpot_postgres_v15:/var/lib/postgresql/data
147
    networks:
148
      - penpot
149
    environment:
150
      - POSTGRES_INITDB_ARGS=--data-checksums
151
      - POSTGRES_DB=penpot
152
      - POSTGRES_USER=penpot
153
      - POSTGRES_PASSWORD=penpot
154

155
  # Valkey缓存服务（兼容Redis协议），实时消息、会话缓存
156
  penpot-valkey:
157
    image: valkey/valkey:8.1
158
    restart: always
159
    # 缓存健康检测
160
    healthcheck:
161
      test: ["CMD-SHELL", "valkey-cli ping | grep PONG"]
162
      interval: 1s
163
      timeout: 3s
164
      retries: 5
165
      start_period: 3s
166
    networks:
167
      - penpot
168
    environment:
169
      # 限制最大内存及淘汰策略
170
      - VALKEY_EXTRA_FLAGS=--maxmemory 128mb --maxmemory-policy volatile-lfu
171

172
  # 测试用邮件捕获服务，接收所有系统发送邮件，1080端口网页查看
173
  # 生产环境请替换为真实SMTP服务器
174
  penpot-mailcatch:
175
    image: sj26/mailcatcher:latest
176
    restart: always
177
    expose:
178
      - '1025'
179
    ports:
180
      - "1080:1080"
181
    networks:
182
      - penpot

展开收起

访问 http://localhost:9001 即可使用。

📝 使用指南#

快速开始#

访问 Penpot（SAAS 版本或自建部署）
注册账户，创建团队
创建新项目
开始设计

设计流程#

1
1. 创建设计文件
2
2. 使用设计令牌定义样式
3
3. 创建组件和变体
4
4. 设计响应式界面
5
5. 团队协作评审
6
6. 导出代码（SVG/CSS/HTML）
7
7. 开发者实现
8
8. 通过 MCP 更新设计

开发者工作流#

1
1. 使用 Inspect 模式查看代码
2
2. 导出 SVG/CSS/HTML
3
3. 理解设计令牌
4
4. 实现设计
5
5. 通过 API 更新设计
6
6. 保持设计和代码同步

📊 对比其他方案#

方案	开源	自托管	设计即代码	设计令牌	团队协作	成本
Penpot	✅	✅	✅	✅	✅	🆓
Figma	❌	❌	❌	✅	✅	付费
Sketch	❌	❌	❌	✅	✅	付费
Adobe XD	❌	❌	❌	✅	✅	付费
InVision	❌	❌	❌	❌	✅	付费

📜 开源协议#

Penpot 采用 MPL-2.0（Mozilla Public License 2.0）开源协议：

可以免费使用、修改和分发
修改后的代码需要开源
适合商业和非商业用途

📝 总结#

Penpot 是一款功能强大的开源设计平台，特别适合需要自托管部署、设计开发协作的团队。它支持实时协作、设计即代码、设计令牌、MCP服务器等核心功能，让设计和开发之间的工作流更加顺畅。无论是初创团队还是大型企业，都能从中受益。如果你正在寻找一个替代 Figma 的开源方案，或者需要在公司内网部署设计工具，Penpot 绝对值得一试！

🌟 项目资源#

官方网站: https://penpot.app

GitHub 地址: https://github.com/penpot/penpot

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你在团队协作设计中遇到过什么问题？最希望设计工具支持什么功能？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！yantr：自托管应用商店，不占用系统资源，130+应用一键部署

2026-06-23T00:00:00.000Z

朋友们！想自建家庭服务器却怕折腾？#

你是不是经常遇到这些困扰：

Umbrel太笨重：要占用整台机器，安装后其他应用没法用
Docker Compose太麻烦：每个应用都要写配置文件，记不住端口
端口冲突头疼：多个应用争用端口，排查半天
数据不好管理：应用数据散落在各处，备份恢复麻烦
想装的应用太多：每次都要找镜像、写配置，太耗时

今天我要给大家分享一个 GitHub 上的宝藏项目——yantr！这个自托管应用商店作为单个容器运行，不占用系统资源，支持 130+ 精选应用一键部署，让自建服务变得无比简单！

✨ 什么是 yantr？#

yantr 是一个自托管的应用商店，它与您的操作系统并行运行，而不是替代它。它作为单个 Docker 容器运行在您已有的机器上——笔记本电脑、树莓派、旧 PC、家庭服务器都可以。您的主机保持不变，文件保持原位，yantr 只是管理 Docker stacks。

核心特点：

🐳 单容器运行：只需一个容器，无需数据库，无外部依赖
📦 130+ 精选应用：涵盖 AI、媒体、下载、云存储、安全等多个类别
⚡ 一键部署：点击即可安装，无需手动编写配置
🔒 零系统足迹：从不写入主机，卸载后不留痕迹
🎯 完整环境控制：每个应用可自定义环境变量，支持重复部署
🚫 无依赖冲突：每个应用自带运行时，互不干扰
🌐 内置网络：端口冲突检测、Tailscale、Cloudflare Tunnel、Caddy HTTPS
📁 卷浏览器：从浏览器直接管理应用数据
🔌 REST API：所有操作都有 JSON 端点，支持脚本和 CLI

🎯 130+ 应用分类#

yantr 提供了丰富的应用目录，涵盖各种使用场景：

🤖 AI & Agents#

1
- Open WebUI：开源 AI 聊天界面，支持多种模型
2
- Perplexica：AI 搜索聚合器
3
- Agent Zero：AI 智能代理
4
- Kokoro：AI 知识库助手

🎬 Media（媒体服务）#

1
- Jellyfin：开源媒体服务器
2
- Emby：媒体管理和播放
3
- Stremio：流媒体聚合器
4
- Swingmusic：轻量级音乐服务器
5
- Metube：YouTube 下载器

📥 Downloads（下载工具）#

1
- qBittorrent：BT 下载客户端
2
- Radarr：电影自动下载管理
3
- Sonarr：电视剧自动下载管理
4
- Jackett：Tracker 聚合器
5
- Prowlarr：索引器管理器

☁️ Cloud & Files（云存储）#

1
- Nextcloud：私有云存储
2
- Seafile：文件同步共享
3
- Syncthing：点对点文件同步
4
- MinIO：对象存储

🔐 Security（安全工具）#

1
- Vaultwarden：密码管理器
2
- AdGuard Home：广告拦截和 DNS
3
- Pi-hole：网络级广告拦截
4
- WireGuard：虚拟专用网络

🛠️ Dev Tools（开发工具）#

1
- Supabase：开源 Firebase 替代品
2
- PostgreSQL：关系型数据库
3
- MongoDB：文档数据库
4
- n8n：工作流自动化
5
- Gitea：自托管代码仓库

📡 Networking（网络工具）#

1
- Tailscale：零配置 VPN
2
- Cloudflare Tunnel：安全隧道
3
- Glances：系统监控

📝 Productivity（生产力工具）#

1
- Memos：极简笔记应用
2
- Wiki.js：现代化 Wiki
3
- Linkwarden：书签管理
4
- FreshRSS：RSS 阅读器

💰 Finance（财务工具）#

1
- Actual Budget：零基预算管理
2
- Ghostfolio：投资组合追踪
3
- Rotki：隐私优先的投资追踪

🚀 快速开始#

前置要求#

Docker：需要安装 Docker
Linux 主机：推荐使用 Linux（macOS/Windows 需要特殊配置）

一键部署#

Terminal window

1
docker run -d \
2
  --name yantr \
3
  --network host \
4
  -v /var/run/docker.sock:/var/run/docker.sock \
5
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
6
  --restart unless-stopped \
7
  ghcr.io/besoeasy/yantr

访问应用#

打开 **http://localhost:5252**，首次访问时创建管理员账户即可使用。

macOS / Windows 用户#

由于 host 网络仅支持 Linux，macOS 和 Windows 用户需要配置端口映射：

Terminal window

1
docker run -d \
2
  --name yantr \
3
  -p 5252:5252 \
4
  -v /var/run/docker.sock:/var/run/docker.sock \
5
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
6
  --restart unless-stopped \
7
  ghcr.io/besoeasy/yantr

📝 使用场景#

场景一：家庭媒体中心#

1
部署应用：
2
- Jellyfin：媒体服务器
3
- qBittorrent：下载工具
4
- Radarr/Sonarr：自动下载电影和电视剧
5
- Metube：YouTube 视频下载
6

7
效果：打造完整的家庭媒体中心，随时随地观看影视内容

场景二：个人云存储#

1
部署应用：
2
- Nextcloud：私有云存储
3
- Syncthing：文件同步
4
- Vaultwarden：密码管理
5

6
效果：数据完全自主可控，告别公有云隐私担忧

场景三：开发环境#

1
部署应用：
2
- Gitea：代码仓库
3
- PostgreSQL：数据库
4
- MongoDB：文档数据库
5
- n8n：工作流自动化
6

7
效果：搭建完整的开发环境，支持团队协作

场景四：AI 工具集#

1
部署应用：
2
- Open WebUI：AI 聊天界面
3
- Perplexica：AI 搜索
4
- Agent Zero：AI 代理
5

6
效果：在本地运行 AI 工具，数据不流出本地

场景五：网络安全#

1
部署应用：
2
- AdGuard Home：广告拦截
3
- Pi-hole：网络级广告过滤
4
- WireGuard：VPN
5

6
效果：保护家庭网络安全，提升上网体验

📜 开源协议#

yantr 采用 ISC 开源协议，完全免费使用。

📝 总结#

yantr 是一款功能强大的自托管应用商店，特别适合想要自建服务但又不想折腾的用户。它作为单个容器运行，不占用系统资源，支持 130+ 精选应用一键部署。与 Umbrel 不同，yantr 不会占用整台机器，您的主机保持不变。与手动 Docker 相比，yantr 提供了可视化管理界面，一键部署、一键更新，让自建服务变得无比简单。无论是搭建家庭媒体中心、个人云存储、开发环境还是 AI 工具集，yantr 都是一个非常好的选择！

🌟 项目资源#

官方网站: https://yantr.org

GitHub 地址: https://github.com/besoeasy/yantr

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你最想在自己的服务器上部署什么应用？在使用自托管服务时遇到过什么问题？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！BentoPDF：浏览器端隐私优先的PDF工具箱，50+工具一键搞定

2026-06-22T00:00:00.000Z

朋友们！处理PDF文件总担心隐私泄露？#

你是不是经常遇到这些困扰：

在线工具不安全：上传PDF到第三方网站处理，担心文件内容被窃取
功能不全：在线PDF工具功能有限，很多高级功能需要付费
文件太大传不了：大文件上传慢，还经常失败
本地软件麻烦：安装本地PDF软件太臃肿，占用空间大
团队协作不便：多人共用电脑，配置麻烦

今天我要给大家分享一个 GitHub 上的宝藏项目——BentoPDF！这个项目是一款隐私优先的浏览器端 PDF 工具箱，所有处理都在浏览器端完成，文件不上传服务器，支持 50+ 工具，可自建部署，完全免费开源！

✨ 什么是 BentoPDF？#

BentoPDF 是一款隐私优先、客户端处理的 PDF 工具箱，支持在浏览器中直接操作、编辑、合并和处理 PDF 文件。所有处理都在本地完成，文件不会上传到服务器，确保您的文件安全和隐私。

核心特点：

🔒 隐私优先：所有处理在浏览器端完成，文件永不上传服务器
📦 50+ 工具：涵盖 PDF 管理、编辑、转换、安全等所有功能
🚀 高性能：基于现代 Web 技术和 WASM，处理速度快
🆓 完全免费：开源免费，无限制使用
🏠 可自建部署：支持 Docker、Netlify、Vercel、GitHub Pages 等多种部署方式
📱 跨平台：支持所有现代浏览器，无需安装任何软件
🎨 美观界面：现代化 UI 设计，操作简单直观

🎯 50+ 工具分类#

1. 组织与管理 PDF#

工具	功能
合并PDF	将多个PDF合并为一个，保留书签
拆分PDF	提取特定页面或分割为多个文件
页面管理	拖拽重排、复制、删除页面
提取页面	保存指定页码范围为新PDF
删除页面	删除不需要的页面
旋转PDF	旋转单个或所有页面
自定义旋转	按任意角度旋转页面
N-Up PDF	多页合并到单页
交替合并	交替合并多个PDF的页面
海报拆分	将PDF拆分为多个小页面用于打印
PDF小册子	重排页面用于双面打印成书册
添加附件	嵌入文件到PDF中
提取附件	从PDF中提取所有附件
反转页面	反转所有页面顺序

2. 编辑与修改 PDF#

工具	功能
PDF编辑器	标注、高亮、批注、添加形状/图片
创建表单	创建可填写的PDF表单（文本框、复选框、下拉框等）
表单填写	直接在浏览器中填写表单
添加页码	自定义格式添加页码
Bates编号	跨多个PDF添加连续编号
添加水印	添加文字或图片水印
页眉页脚	添加自定义页眉页脚
裁剪PDF	裁剪特定页面或整个文档
自动纠偏	自动修正倾斜的扫描页面
字体转轮廓	将字体转换为矢量轮廓
颜色反转	反转PDF页面颜色
背景修改	修改PDF背景颜色
文本颜色	修改PDF中文本颜色
扁平化PDF	将表单字段和注释合并为静态内容
移除注释	移除所有批注和高亮
移除空白页	自动检测并移除空白页
编辑书签	添加、编辑、导入导出书签
目录生成	从书签生成目录页
内容遮蔽	永久移除敏感内容
扫描效果	使PDF看起来像扫描件

3. 转换为 PDF#

工具	功能
Word转PDF	DOCX/DOC文件转换为PDF
图片转PDF	多张图片合并为PDF
HTML转PDF	HTML页面转换为PDF
URL转PDF	网页链接转换为PDF
Markdown转PDF	Markdown文件转换为PDF
EPUB转PDF	EPUB电子书转换为PDF
MOBI转PDF	MOBI电子书转换为PDF
XPS转PDF	XPS文件转换为PDF

4. 从 PDF 转换#

工具	功能
PDF转Word	PDF转换为DOCX文件
PDF转图片	PDF转换为PNG/JPEG图片
PDF转文本	提取PDF中的文本内容
PDF转Markdown	PDF转换为Markdown格式
PDF转SVG	PDF转换为SVG矢量图
PDF转EPUB	PDF转换为EPUB电子书
PDF转JSON	PDF转换为JSON格式

5. 安全与优化#

工具	功能
添加密码	设置PDF打开密码
移除密码	解密受保护的PDF
数字签名	添加数字签名
权限设置	设置打印、复制、编辑权限
PDF压缩	压缩PDF文件大小
PDF/A转换	转换为PDF/A存档格式
文件优化	优化PDF文件结构

🚀 部署方式#

方式一：使用官方在线版本#

直接访问 BentoPDF 官网，无需安装，打开浏览器即可使用。

方式二：Docker 部署（推荐）#

Terminal window

1
# 运行容器
2
docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest

访问 http://localhost:3000 即可使用。

方式三：Docker Compose#

1
services:
2
  bentopdf:
3
    image: ghcr.io/alam00000/bentopdf-simple:latest
4
    container_name: bentopdf
5
    restart: unless-stopped
6
    ports:
7
      - "3000:8080"

启动服务：

Terminal window

1
docker compose up -d

方式四：静态托管#

支持部署到 Netlify、Vercel、GitHub Pages、Cloudflare Pages 等平台：

Fork 项目到您的 GitHub 账户
连接到 Netlify/Vercel/GitHub Pages
自动构建部署

方式五：本地开发#

Terminal window

1
# 安装依赖
2
npm install
3

4
# 开发模式
5
npm run dev
6

7
# 生产构建
8
npm run build

📝 使用指南#

快速开始#

访问 BentoPDF（官方在线版或自建部署）
从左侧工具列表选择您需要的工具
上传或拖拽 PDF 文件到页面
根据工具提示进行操作
下载处理后的文件

实际场景演示#

场景一：合并多个 PDF#

1
操作步骤：
2
1. 选择"合并PDF"工具
3
2. 上传多个PDF文件
4
3. 拖拽调整顺序
5
4. 点击"合并"按钮
6
5. 下载合并后的PDF

场景二：添加水印#

1
操作步骤：
2
1. 选择"添加水印"工具
3
2. 上传PDF文件
4
3. 设置水印文字、大小、颜色、位置
5
4. 点击"添加水印"按钮
6
5. 下载处理后的PDF

场景三：PDF 转 Word#

1
操作步骤：
2
1. 选择"PDF转Word"工具
3
2. 上传PDF文件
4
3. 点击"转换"按钮
5
4. 下载转换后的DOCX文件

📊 对比其他方案#

方案	隐私性	功能数量	部署方式	成本	推荐指数
BentoPDF	✅ 本地处理	50+	多种	🆓	⭐⭐⭐⭐⭐
在线PDF工具	❌ 上传服务器	20+	无	免费/付费	⭐⭐⭐
Adobe Acrobat	✅ 本地处理	50+	本地安装	付费	⭐⭐⭐⭐
PDFelement	✅ 本地处理	30+	本地安装	付费	⭐⭐⭐⭐
LibreOffice	✅ 本地处理	10+	本地安装	🆓	⭐⭐⭐

📝 总结#

BentoPDF 是一款功能强大的隐私优先 PDF 工具箱，特别适合处理敏感文档。它支持 50+ 工具，涵盖 PDF 的所有操作需求，所有处理都在浏览器端完成，文件不会上传到服务器。支持多种部署方式，可以在个人电脑、服务器或云端部署使用。无论是个人用户还是企业用户，都能从中受益。如果你经常处理 PDF 文件，这个工具绝对值得一试！

🌟 项目资源#

GitHub 地址: https://github.com/alam00000/bentopdf

官方网站: https://bentopdf.com

使用文档: https://bentopdf.com/docs/

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你最常用的 PDF 操作是什么？最希望支持什么功能？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub顶级项目！freeCodeCamp：免费学编程，已有10万人靠它转行成功

2026-06-22T00:00:00.000Z

朋友们！想学编程却不知道从哪开始？#

你是不是经常遇到这些困扰：

想学编程但没钱：市面上的编程课程动辄几千上万，太贵了
不知道学什么：前端、后端、Python、AI，方向太多，不知道怎么选
学了用不上：理论知识学了一堆，实际项目做不出来
没有学习氛围：一个人学习太孤单，遇到问题没人问
简历上没东西：想学完能证明自己，却没有拿得出手的认证

今天我要给大家分享一个改变了无数人命运的 GitHub 项目——freeCodeCamp！这是全球最大的免费编程学习社区，已有超过 10万人 靠它成功转行，拿到了第一份开发工作！

✨ 什么是 freeCodeCamp？#

freeCodeCamp（简称 FCC）是一个非营利性的免费编程学习平台，由 donor-supported 501(c)(3) 慈善组织运营。它提供完整的全栈开发和机器学习课程，所有内容完全免费、自定进度学习。

核心特点：

🆓 完全免费：所有课程、认证、学习资源全部免费
🏆 权威认证：完成课程可获得免费的开发者认证，可添加到 LinkedIn 和简历
📚 丰富课程：涵盖前端、后端、Python、数据库、AI 等多个方向
💻 实战项目：每个认证需要完成 5 个实战项目，学以致用
👥 活跃社区：Discord、论坛、YouTube 等多种社区支持
🌍 全球影响力：帮助超过 10 万人成功转行，GitHub 星标超 37 万
🔄 自定进度：按照自己的节奏学习，无需赶进度

🎯 课程体系#

全栈开发认证（Full-Stack Developer Curriculum）#

freeCodeCamp 提供 6 个核心认证，组成完整的全栈开发课程体系：

1. Responsive Web Design（响应式网页设计）#

学习内容：HTML、CSS、Flexbox、Grid 布局
项目实践：构建响应式网页、个人作品集、产品登陆页等
适合人群：零基础入门

2. JavaScript（JavaScript 编程）#

学习内容：基础语法、DOM 操作、异步编程、算法
项目实践：计算器、待办清单、随机引语生成器等
适合人群：有基础 HTML/CSS 知识

3. Front-End Development Libraries（前端开发库）#

学习内容：React、Redux、Bootstrap、D3.js、jQuery
项目实践：React 电商应用、图表可视化、Markdown 编辑器等
适合人群：掌握 JavaScript 基础

4. Python（Python 编程）#

学习内容：Python 基础、面向对象、数据分析、机器学习入门
项目实践：数据可视化、机器学习模型、自动化脚本等
适合人群：想学习后端或数据科学

5. Relational Databases（关系型数据库）#

学习内容：SQL、PostgreSQL、数据库设计、ORM
项目实践：构建数据库、数据查询、项目管理系统等
适合人群：全栈开发必备

6. Back-End Development and APIs（后端开发与 API）#

学习内容：Node.js、Express、MongoDB、RESTful API
项目实践：博客系统、认证系统、API 服务等
适合人群：想成为全栈开发者

语言认证#

freeCodeCamp 还提供免费的语言认证，帮助开发者提升职场竞争力：

A2 English for Developers（Beta）：初级英语认证
B1 English for Developers（Beta）：中级英语认证
A1 Professional Spanish（Beta）：初级西班牙语认证
A1 Professional Chinese（Beta）：初级中文认证

其他学习资源#

除了核心课程，freeCodeCamp 还提供丰富的学习资源：

The Odin Project（Remix）：深入的 Web 开发课程
Coding Interview Prep：面试准备题库
Project Euler：数学编程挑战
Rosetta Code：多语言代码对比
Foundational C# with Microsoft：微软合作的 C# 基础认证

🚀 学习路径#

零基础入门路径#

1
1. 响应式网页设计（HTML/CSS）→ 获得认证
2
2. JavaScript 编程 → 获得认证
3
3. 前端开发库（React等）→ 获得认证
4
4. Python 编程 → 获得认证
5
5. 关系型数据库（SQL）→ 获得认证
6
6. 后端开发与 API → 获得认证

完成以上 6 个认证，即可成为合格的全栈开发者！

进阶学习路径#

1
1. 深入学习前端框架（React/Vue/Angular）
2
2. 学习后端框架（Django/Flask/Express）
3
3. 掌握数据库技术（MySQL/PostgreSQL/MongoDB）
4
4. 学习 DevOps（Docker/Kubernetes）
5
5. 了解 AI/机器学习基础
6
6. 参与开源项目贡献

📝 学习方式#

1. 交互式学习#

freeCodeCamp 采用交互式学习方式，边学边练：

1
- 阅读课程内容
2
- 完成编程挑战
3
- 实时反馈代码
4
- 渐进式难度提升

2. 项目实战#

每个认证需要完成 5 个实战项目，真正学以致用：

1
示例项目：
2
- 响应式网页设计：构建个人作品集网站
3
- JavaScript：创建一个计算器应用
4
- React：开发一个电商购物车
5
- Python：数据分析可视化项目
6
- 后端开发：构建一个博客系统

3. 社区支持#

freeCodeCamp 拥有活跃的社区，遇到问题可以随时求助：

社区平台	功能
Discord	实时聊天，快速获得帮助
论坛	编程问题、项目反馈，通常几小时内回复
YouTube	免费视频课程，覆盖多种技术
News	技术文章、教程，涵盖编程、数学、计算机科学

📊 学习效果#

成功案例#

freeCodeCamp 帮助超过 10万人 成功转行，以下是一些真实案例：

1
- 从超市收银员到前端开发工程师
2
- 从教师到全栈开发工程师
3
- 从护士到数据科学家
4
- 从销售到后端开发工程师
5
- 从会计到移动端开发工程师

认证价值#

freeCodeCamp 认证可以添加到 LinkedIn 和简历中，当雇主点击链接时，可以看到您的验证证书。这是展示您技能的有力证明。

⚠️ 注意：freeCodeCamp 严格执行学术诚信政策，如果发现抄袭，将撤销认证并封禁账号。

📜 开源协议#

freeCodeCamp 采用 BSD-3-Clause 开源协议：

软件代码：BSD-3-Clause 许可证
课程内容：freeCodeCamp.org 版权所有

freeCodeCamp 是一个捐赠支持的非营利组织，您可以通过捐赠支持项目发展。

📝 总结#

freeCodeCamp 是全球最大的免费编程学习社区，它提供完整的全栈开发课程体系，支持前端、后端、Python、数据库等多个方向。所有课程完全免费，完成认证可获得权威的开发者证书。已有超过 10 万人靠它成功转行，拿到了第一份开发工作。如果你想学编程但不知道从哪开始，或者想系统地提升编程技能，freeCodeCamp 绝对是最佳选择！

🌟 项目资源#

官方网站: https://www.freecodecamp.org

GitHub 地址: https://github.com/freeCodeCamp/freeCodeCamp

学习路径: https://www.freecodecamp.org/learn/full-stack-developer-v9/

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你是怎么开始学习编程的？在学习过程中遇到过什么困难？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具和学习资源，记得关注我哦！

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

网页秒变桌面应用！PakePlus：比Electron小20倍，5M体积全搞定

2026-06-20T00:00:00.000Z

朋友们！想把网页变成桌面应用吗？#

你是不是经常遇到这些需求：

想把网站打包成应用：有个好用的网站，想做成桌面应用，方便日常使用
Vue/React项目想打包：不想买服务器，直接把前端项目打包成桌面应用
游戏想跨平台运行：Cocos/Unity游戏想做成跨平台客户端
隐藏网站地址：不想让别人直接访问你的网站，只通过客户端访问
内部平台限制访问：公司内部平台，只想通过专用客户端访问
Electron太重了：Electron打包的应用动不动几百MB，太占空间

今天我要给大家分享一个 GitHub 上的神器——PakePlus（PacBao）！这个工具可以把任何网页、Vue、React 项目打包成桌面和移动应用，体积小于 5MB，比 Electron 小 20 倍、快 10 倍！

✨ 什么是 PakePlus？#

PakePlus（PacBao）是一款基于 Rust Tauri 构建的跨平台应用打包工具。它可以将任何网页、Vue、React 等项目快速打包成桌面和移动应用，无需本地安装复杂依赖，体积小、速度快。

核心特点：

💎 超小体积：比 Electron 小 20 倍，打包的应用小于 5MB
🚀 极速启动：比 JavaScript 框架快 10 倍，基于 Rust Tauri 构建
📦 丰富功能：支持快捷键、沉浸式窗口、极简自定义
📲 多平台支持：Mac、Windows、Linux、Android、iOS 全覆盖
🌹 零依赖：无需本地安装复杂依赖，云端自动打包
🤗 简单易用：只需一个 GitHub Token，即可获得桌面应用
🍔 本地打包：支持本地打包，无需 Token，30秒搞定
🍀 静态文件打包：支持 Vue/React 的 dist 文件夹直接打包
💡 自定义注入：支持自定义 JavaScript 注入，实现自动化和自定义功能
🎨 美观UI：界面美观，对新手友好，支持中文命名

🎯 核心功能#

1. 网页打包成应用#

只需输入网站 URL，即可将任何网页打包成桌面应用：

1
示例：
2
- https://chatgpt.com → ChatGPT 桌面应用
3
- https://notion.so → Notion 桌面应用
4
- https://docs.google.com → Google Docs 桌面应用

2. Vue/React 项目打包#

将 Vue/React 项目编译后的 dist 文件夹直接打包：

1
示例：
2
- Vue 项目 dist 文件夹 → 桌面应用
3
- React 项目 dist 文件夹 → 桌面应用
4
- Vite 构建项目 → 桌面应用

3. 自定义功能#

JavaScript 注入：注入自定义 JS，实现自动化和自定义功能
隐藏广告：注入 JS 隐藏网页广告
系统级 API：支持调用系统级 API（下载文件、执行命令、打开新窗口等）
调试模式：支持调试模式，快速定位和修复问题

🚀 使用方式#

方式一：客户端应用（推荐）#

下载应用：访问 GitHub Release 下载客户端
安装运行：双击安装并运行应用
配置 Token：配置 GitHub Token 或使用本地打包
创建项目：创建新项目，设置配置（名称、URL、图标等）
预览发布：预览应用，点击发布按钮打包
下载应用：从 Release 页面下载打包好的应用

方式二：Web 版本#

直接访问 PacBao Web 使用网页版本，无需下载客户端。

📊 对比其他方案#

方案	体积	速度	跨平台	复杂度	推荐指数
PakePlus	⚡ 5MB	⚡ 10x	✅ 全平台	⭐ 简单	⭐⭐⭐⭐⭐
Electron	~100MB	1x	✅ 全平台	⭐⭐⭐ 中等	⭐⭐⭐
Tauri	~10MB	10x	✅ 全平台	⭐⭐⭐⭐ 复杂	⭐⭐⭐⭐
PWA	~5MB	5x	✅ 全平台	⭐⭐ 简单	⭐⭐⭐⭐
原生开发	~20MB	20x	❌ 单平台	⭐⭐⭐⭐⭐ 很难	⭐⭐

⚠️ 注意事项#

Mac 用户提示#

Mac 用户安装时可能会看到”应用已损坏”的警告，解决方法：

Terminal window

1
sudo xattr -r -d com.apple.quarantine /Applications/PacBao.app

GitHub Token 权限#

使用 GitHub Token 打包时，需要以下权限：

Beta 版本：

All repositories：Fork 原始模板仓库
Actions：管理 GitHub actions
Administration：Fork 和管理仓库文件
Contents：添加、删除、修改和查找仓库内容
Issues：向 PacBao 提交问题

Classic 版本：

repo：Fork 和管理模板代码
workflow：编译和发布软件

合法使用#

请合法合规使用此软件，仅限个人使用，不得传播或用于商业目的。

📝 总结#

PakePlus 是一款功能强大的跨平台应用打包工具，特别适合将网页、Vue/React 项目快速打包成桌面和移动应用。它基于 Rust Tauri 构建，体积小、速度快，比 Electron 小 20 倍、快 10 倍。支持云端自动打包和本地打包，无需复杂依赖，30秒内完成打包。无论是个人用户还是企业用户，都能从中受益。如果你想把网页变成应用，这个工具绝对值得一试！

🌟 项目资源#

GitHub 地址: https://github.com/Sjj1024/PakePlus

官方网站: https://pakeplus.com

Web 版本: https://pakeplus.pages.dev

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你最想把什么网站打包成应用？最期待什么功能？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

服务器到期宕机？域名过期被抢注？这个工具帮你守住所有服务

2026-06-19T00:00:00.000Z

朋友们！服务到期总忘记？#

你是不是每天都要面对这些困扰：

域名续费忘了：辛辛苦苦做的网站，域名过期被抢注，欲哭无泪
服务器到期忘了：半夜服务宕机，紧急充值，手忙脚乱
订阅服务忘了：自动续费扣了钱才发现，想退都来不及
通知渠道太少：手机短信容易漏，邮件看不到，错过重要提醒
没有统一管理：各种服务分散在不同平台，到期时间记不住

今天我要给大家分享一个 GitHub 上的宝藏项目——RenewHelper（时序·守望）！这个项目让管理周期性订阅变得无比简单，支持公历/农历周期计算、多渠道通知推送、资金流向看板，零成本托管！

✨ 什么是 RenewHelper？#

RenewHelper（时序·守望）是一款基于 Cloudflare Workers 的全栈服务生命周期提醒、管理工具。它专为管理周期性订阅、域名续费、服务器到期等场景设计，无需服务器，零成本托管。

核心特点：

⚡ Serverless 架构：完全运行在 Cloudflare Workers 上，免费额度足够个人使用
📅 公历/农历双支持：内置高精度农历算法（1900-2100），支持公历循环和农历循环
🔔 多渠道通知：支持 Telegram、Bark、PushPlus、钉钉、飞书、企微等 12+ 种通知渠道
💰 资金流向看板：支持多币种混合统计，按月/年查看消费趋势
📆 日历同步：支持 ICS 订阅，完美接入 iOS 日历、Google Calendar
🛡️ 安全可靠：JWT 身份验证，数据仅存储在您私有的 Cloudflare KV 中
🎨 现代化 UI：Vue 3 + Element Plus，支持深色/浅色模式，响应式设计

🎯 核心功能#

1. 智能周期管理#

支持三种模式：

模式	说明	适用场景
循环订阅	到期自动更新下次提醒时间	月付/年付订阅
到期重置	到期后标记为过期，需手动处理	一次性服务
固定重复	按固定间隔重复提醒	生日、纪念日

支持公历和农历两种周期计算：

公历循环：月付、季付、年付等固定间隔
农历循环：生日、传统节日等农历日期

2. 多渠道通知推送#

支持 12+ 种通知渠道，可无限添加，支持为每个项目配置不同的推送渠道：

渠道	适用平台	特点
Telegram	全平台	即时推送，支持群组
Bark	iOS	轻量推送，无需服务器
PushPlus	微信	微信公众号推送
Server酱	微信	微信服务号推送
钉钉	企业	企业内部通知
飞书	企业	企业内部通知
企微	企业	企业微信通知
Resend	邮件	邮件通知
Gotify	自建	自建通知服务
Ntfy	全平台	开源通知服务
Webhook	自定义	自定义集成

3. 资金流向看板#

提供精美的账单统计视图：

按月、按年查看消费趋势
支持多币种混合统计（自动汇率转换）
区分账单金额（预算）与实际支出（实付）
未来 n 天待付账单预览

4. 日历可视化 & ICS 订阅#

内置日历面板：直观查看当月各种续费事件及未来的预测待办
ICS 订阅：提供标准的 .ics 订阅链接，可完美接入 iOS 日历、Google Calendar、Outlook
时区支持：支持基于时区的精确提醒

5. 自动化管理#

自动续期：到期自动更新下次提醒时间
自动禁用：过期太久未处理的服务自动标记为禁用
Cron 触发：支持通过 Cloudflare Cron Triggers 每日定时检查

6. 安全可靠#

JWT 身份验证：支持高强度密钥自动生成
混合限流策略：内存 + KV，防止暴力破解
数据私有化：数据仅存储在您私有的 Cloudflare KV 中
二次确认：敏感操作（删除、重置）需要二次确认

🚀 部署方式#

方式一：一键部署到 Cloudflare Workers（推荐）#

点击按钮即可完成部署：

部署后需要设置：

添加环境变量 AUTH_PASSWORD（登录密码）
绑定 KV 命名空间 RENEW_KV
设置 Cron Triggers：0,30 * * * *

方式二：Docker 部署（私有化）#

1
services:
2
  renew-helper:
3
    image: ieax/renewhelper:latest
4
    container_name: renew-helper
5
    restart: unless-stopped
6
    ports:
7
      - "9787:9787"
8
    volumes:
9
      - ./data:/data
10
    environment:
11
      - AUTH_PASSWORD=你的访问密码
12
      - CRON_SCHEDULE=0,30 * * * *
13
      - TZ=Asia/Shanghai

启动服务：

Terminal window

1
docker compose up -d

⚠️ 注意：需要配置 HTTPS 反向代理（Nginx/Caddy）

📊 对比其他方案#

方案	成本	部署难度	通知渠道	农历支持	资金看板
RenewHelper	免费	⭐⭐	12+	✅	✅
Notion 模板	免费	⭐	少	❌	手动
手机日历	免费	⭐	少	部分	❌
付费订阅管理	付费	⭐	多	❌	✅

📝 总结#

RenewHelper 是一款功能强大的服务生命周期管理工具，特别适合管理域名续费、服务器到期、订阅服务等周期性任务。它基于 Cloudflare Workers 实现零成本托管，支持公历/农历双周期计算、12+ 种通知渠道、资金流向看板和 ICS 日历同步。无论是个人用户还是企业用户，都能从中受益。如果你经常忘记服务到期，这个工具绝对值得一试！

🌟 项目资源#

GitHub 地址: https://github.com/ieax/renewhelper

Docker 镜像: ieax/renewhelper:latest

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你最常忘记哪些服务的到期时间？最希望支持什么通知渠道？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！DocMD：AI优先的零配置文档引擎，秒级生成生产级文档

2026-06-18T00:00:00.000Z

朋友们！写文档怎么这么麻烦？#

你是不是每天都要面对这些困扰：

配置太复杂：Docusaurus、VitePress、MkDocs……每个都要写一堆配置文件，还要学框架语法
启动太慢：npm install 半天，build 又半天，开发体验极差
AI 支持弱：想让 AI 助手读取文档，还要手动整理，太麻烦了
迁移成本高：从一个工具换到另一个，配置和结构全要改
体积太大：生成的页面动不动几百 KB，加载慢死了

今天我要给大家分享一个 GitHub 上的宝藏项目——DocMD！这个项目让写文档变得无比简单，零配置启动，AI 原生支持，一行命令搞定所有！

✨ 什么是 DocMD？#

DocMD 是一款 AI 优先的零配置文档引擎，专为开发者和 LLM 代理设计。它的核心理念是：文档工具应该消失，让你专注于写作。

核心特点：

⚡ 零配置启动：无需任何配置文件，直接运行即可
🤖 AI 原生支持：内置 MCP Server、AI Context，AI 助手可直接读取文档
📦 超小体积：初始加载仅 18KB，比 Docusaurus 小 13 倍
🚀 秒级启动：npx @docmd/core dev 一行命令，瞬间启动开发服务器
📱 生产就绪：静态 HTML、SEO 优化、PWA 支持，开箱即用

🎯 核心功能#

1. 零配置，秒级启动#

Terminal window

1
# 直接在任意包含Markdown文件的文件夹中运行
2
npx @docmd/core dev
3

4
# 启动完成！访问 http://localhost:3000

就是这么简单！无需配置文件、无需安装依赖、无需学习新语法。导航自动生成，页面瞬间渲染，你的文档默认就是生产就绪的。

2. AI-First 集成#

DocMD 是首个专为 AI 时代设计的文档工具：

MCP Server

Terminal window

1
docmd mcp

启动 MCP Server，AI 代理可通过标准输入输出搜索、读取和验证文档。

AI Context 生成

llms.txt / llms-full.txt — 构建时自动生成完整文档上下文
AI 助手可直接读取这些文件，无需手动整理

AI 友好的复制按钮

页面内置 “Copy Markdown” / “Copy Context” 按钮
一键复制，优化 AI 聊天体验

3. 生产就绪的输出#

Terminal window

1
npx @docmd/core build

生成的文档包含：

✅ 静态 HTML（无运行时依赖）
✅ SEO 优化（sitemap、canonical、redirects）
✅ 离线搜索（模糊匹配）
✅ PWA 支持（离线导航）
✅ 多语言支持（i18n）
✅ 版本管理

4. 一键迁移和部署#

Terminal window

1
# 从其他工具迁移
2
docmd migrate   # 支持 Docusaurus、VitePress、MkDocs 等
3

4
# 生成部署配置
5
docmd deploy    # 自动生成 Docker、Nginx、Caddy 配置

5. 丰富的插件生态#

插件	状态	描述
`search`	✅ 默认	离线全文搜索，支持模糊匹配
`seo`	✅ 默认	SEO 标签和 Open Graph 元数据
`sitemap`	✅ 默认	生成 sitemap.xml
`llms`	✅ 默认	AI 上下文生成
`mermaid`	✅ 默认	Markdown 中的 Mermaid 图表
`openapi`	✅ 默认	OpenAPI 3.x 规范渲染器
`pwa`	📦 可选	渐进式 Web App 支持
`math`	📦 可选	KaTeX/LaTeX 数学公式渲染

安装可选插件：

Terminal window

1
docmd add pwa
2
docmd add math

🚀 安装教程#

方法一：npx 直接运行（推荐）#

Terminal window

1
# 开发模式
2
npx @docmd/core dev
3

4
# 生产构建
5
npx @docmd/core build

方法二：全局安装#

Terminal window

1
npm install -g @docmd/core
2

3
# 开发模式
4
docmd dev
5

6
# 生产构建
7
docmd build

方法三：Docker 运行#

Terminal window

1
docker run -p 3000:3000 ghcr.io/docmd-io/docmd:0.8.6

方法四：项目依赖安装#

Terminal window

1
npm install @docmd/core --save-dev

在 package.json 中添加脚本：

1
{
2
  "scripts": {
3
    "docs:dev": "docmd dev",
4
    "docs:build": "docmd build"
5
  }
6
}

📝 使用指南#

快速开始#

Terminal window

1
mkdir my-docs && cd my-docs

创建一些 Markdown 文件：

Terminal window

1
mkdir docs
2
echo "# 欢迎使用 DocMD" > docs/index.md
3
echo "# API 文档" > docs/api.md
4
echo "# 快速开始" > docs/getting-started.md

启动开发服务器：

Terminal window

1
npx @docmd/core dev

访问 http://localhost:3000，你的文档已经准备好了！

配置示例（可选）#

当你需要更多控制时，创建 docmd.config.json：

1
const { defineConfig } = require('@docmd/core');
2

3
module.exports = defineConfig({
4
  title: 'My Project',
5
  url: 'https://docs.myproject.com',
6

7
  // 版本管理
8
  versions: {
9
    current: 'v2',
10
    all: [
11
      { id: 'v2', dir: 'docs' },
12
      { id: 'v1', dir: 'docs-v1' }
13
    ]
14
  },
15

16
  // 多语言支持
17
  i18n: {
18
    default: 'zh',
19
    locales: [
20
      { id: 'zh', label: '中文' },
21
      { id: 'en', label: 'English' },
22
    ]
23
  }
24
});

展开收起

📊 对比其他文档工具#

特性	DocMD	Docusaurus	MkDocs	VitePress	Mintlify
语言	Node.js	React.js	Python	Vue	SaaS
需要配置	❌ 零配置	✅ 需要	✅ 需要	✅ 需要	✅ 需要
初始体积	⚡ 18KB	~250KB	~40KB	~50KB	~120KB
导航	即时 SPA	React SPA	全页刷新	Vue SPA	Hosted SPA
版本管理	✅ 原生	✅ 复杂	插件	手动	✅
多语言	✅ 原生	✅ 复杂	插件	✅	✅
搜索	✅ 内置	Algolia	✅	MiniSearch	Cloud
AI Context	✅ 内置	❌	❌	❌	✅
MCP Server	✅ 内置	❌	❌	❌	✅
Docker	✅ 官方	❌	✅	❌	N/A
自托管	✅	✅	✅	✅	❌
成本	🆓 开源	🆓 开源	🆓 开源	🆓 开源	Freemium

📝 总结#

DocMD 是一款真正为 AI 时代设计的文档工具。它以零配置为核心，让你专注于写作而非配置；以 AI 原生为特色，让文档与 AI 助手无缝协作；以超小体积为优势，提供极速的加载体验。如果你正在寻找一款简单、高效、AI 友好的文档工具，DocMD 绝对值得一试！

🌟 项目资源#

GitHub 地址: https://github.com/docmd-io/docmd

官方网站: https://docmd.io

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你平时用什么工具写文档？最希望文档工具支持什么功能？欢迎在评论区和我交流分享！

我会定期分享更多好用的开发工具，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

dotnet9中的认证鉴权学习

2026-06-17T12:32:13.000Z

1.简介#

OpenAPI

类型：接口规范标准

作用：

生成标准化 API 文档（JSON/YAML 格式）。
支持客户端 SDK 自动生成。
支持 API 版本化（v1、v2…）并在文档中体现。

适用环境：开发环境 + 生产环境。

特点：

偏向“规范化文档”，强调接口定义的标准和一致性。
可以在 Swagger UI 或 Redoc 上展示。

Scalar

类型：开发环境工具 / Minimal API 可视化。

作用：

提供交互式 API 浏览界面，快速查看接口、参数、返回值。
集成 API 版本化，方便开发者调试不同版本的接口。
支持 Minimal API，提供根路径重定向（如 / → /scalar/v1）。

适用环境：仅开发环境。

特点：

偏向“开发体验”，方便快速调试 Minimal API。
并不生成标准文档或 SDK，主要供开发者内部使用。

OpenAPI 与 Scalar 的关系

功能 / 特性	OpenAPI	Scalar
核心用途	标准化接口文档	开发环境 API 浏览与调试
适用环境	开发 + 生产	开发环境
Minimal API 支持	需要手动集成	原生支持
API 版本化	支持	支持，并可与 OpenAPI 集成
接口调试	可选，但不是核心	核心功能
文档标准化	是	否

2.基本使用#

在 .NET 9 中，Web API 模板里 Program.cs 通常会有：builder.Services.AddOpenApi()、app.MapOpenApi() 这样的调用，用于生成OpenAPI 规范文档（通常输出为 /openapi/v1.json 或类似路径）。

image-20251031170754363

启动项目后可打开OpenAPI 规范文档

1
https://localhost:7031/openapi/v1.json

image-20251031170949411

虽然规范文档自动生成，但交互式文档界面（像以前常见的 Swashbuckle.AspNetCore／Swagger UI）在 .NET 9 模板中已经 不再默认 引入。如果你想有漂亮的 UI 文档页面／测试接口功能，可以选择第三方工具，比如 Scalar.AspNetCore（简称 “Scalar”）来做补充。

安装 Scalar.AspNetCore 包

image-20251031171208860

然后在 Program.cs 中加入 app.MapScalarApiReference() 即可

image-20251102002943714

然后启动项目，再次访问

1
https://localhost:7031/scalar/

image-20251031171319037

这只是Scalar的基本使用，正常开发会添加很多Scalar配置，具体可参考ehop相关

image-20251031171509868

3.`ehop`中使用`Scalar`#

还是简单过一下eshop中的代码

在appsettings.json中配置Scalar

image-20251102003401706

image-20251102173420418

获取appsettings.json中的OpenApi和Identity相关配置

image-20251102173537913

所有的服务都配置了2个版本的接口文档

image-20251102173814101

3.1配置文档标题和描述(`ApplyApiVersionInfo`)#

然后我们具体看一下OpenAPI 文档的相关配置

把配置文件中 OpenApi:Document:Title 和 OpenApi:Document:Description 应用到当前文档（指定版本）的元数据中（即 Info.title、Info.description）（设置文档标题和描述）。

1
options.ApplyApiVersionInfo(openApi.GetRequiredValue("Document:Title"), openApi.GetRequiredValue("Document:Description"));

image-20251103193743856

查看一下ApplyApiVersionInfo的具体实现，这个方法设置了版本、标题、描述

image-20251103204717865

然后打开Scalar可以查看到对应的标题和描述

image-20251103165747439

3.2配置授权检查(`ApplyAuthorizationChecks`)#

把读取到的 scopes（scope 名称列表）注入到 OpenAPI 文档的 security requirement / OAuth2 flows 中。目的是让Scalar的 “Authorize” 界面能展示可用的scope，用户可以在 UI 中选择要请求的 scope。

对所有带 [Authorize] 特性的 API 操作：

自动添加 401 Unauthorized 和 403 Forbidden 响应描述。
在 OpenAPI 文档中添加 Security Requirement，绑定 OAuth2 scopes。

scopes.Keys 取自配置文件 Identity:Scopes，表示 API 可以使用哪些权限范围（scope）。

订单服务(Ordering.API)配置的是orders

1
 // 根据 Identity 配置的 Scopes 添加授权检查
2
 options.ApplyAuthorizationChecks([.. scopes.Keys]);

image-20251103193910937

查看ApplyAuthorizationChecks具体实现

设置 401/403 响应描述
绑定 OAuth2 scopes

image-20251103204927560

然后打开Scalar，点击Auth Type，然后选择oauth2

image-20251103194359642

发现我们配置的"orders": "Ordering API"已经正常显示

image-20251103194522424

选择api/orders/cancel接口，最下面有配置的401/403响应描述

image-20251103205331756

3.3配置安全方案(`ApplySecuritySchemeDefinitions`)#

上面配置授权的Scope，这里配置具体的授权方案

将安全方案（security schemes）定义加入到生成的 OpenAPI 文档中（例如 bearerAuth 的 type: http、scheme: bearer，或 OAuth2 的 authorizationCode/implicit/clientCredentials flows）。这一步通常负责在 components.securitySchemes 下注册 scheme，并可能把默认安全要求加入到文档中。

image-20251103194844679

查看ApplySecuritySchemeDefinitions的具体实现：创建oauth2的安全方案

image-20251103205653148

打开Scalar，选择oauth2，显示的就是oauth2的安全方案

正常顺序应该先配置oauth2方案，在配置需要的Scopes，eshop这里代码顺序好像没有影响功能，我这块只是好奇提一下

image-20251103205814938

3.4配置弃用接口(`ApplyOperationDeprecatedStatus`)#

根据 API Versioning 或 [Obsolete] 特性自动标记接口是否已弃用。在生成的 OpenAPI 文档里把接口标记为已弃用，Swagger/Scalar UI 就会显示“Deprecated”提示。

image-20251103211112849

查看ApplyOperationDeprecatedStatus具体实现：

apiDescription.IsDeprecated() ：如果接口被标记为 [Obsolete]返回 true
operation.Deprecated |= ：表示 如果接口已弃用，则在 OpenAPI 文档里设置 deprecated: true
只要 apiDescription 标记为弃用，就把 operation.Deprecated 设置为 true，否则保持原值

|=符号什么意思？

|= 是一种缩写，等价于a = a | b

对 布尔类型，就是 逻辑或赋值

对 整型类型，就是 按位或赋值

image-20251103211426388

经过测试apiDescription.IsDeprecated()不支持 Minimal API，接口加上[Obsolete]没有弃用显示

为什么apiDescription.IsDeprecated()不支持 Minimal API？
apiDescription.IsDeprecated() 并不是检测方法上有没有 [Obsolete]，它是基于 API Versioning（ApiVersionMetadata）来判断“某个版本是否被标为弃用”（看源码）。因此在 Minimal API（通常不会把版本 metadata 放到同样位置）下常常无效。
apiDescription.IsDeprecated() 只能可靠用于 Controller + API Versioning，对于 Minimal API/Scalar，必须手动在 OpenAPI 生成时读取 [Obsolete] 或自定义 Metadata 来标记 Deprecated。

image-20251103221040151

为了演示弃用效果，我还是找到了2种方法：

第二种方法：维护一个弃用的接口列表，读到过期的接口直接operation.Deprecated = true
第三种方法：context.Description.ActionDescriptor?.EndpointMetadata 获取当前 API 方法（Endpoint）上附加的所有元数据（Attributes/特性），例如 [Obsolete]、授权特性等。如果有ObsoleteAttribute返回operation.Deprecated = true，并且可以获取弃用设置的消息。

image-20251103223125039

然后在接口加上[Obsolete("自定义消息")]特性和提示弃用的消息，有2种方法：

使用WithMetadata链式添加
直接在方法上添加特性

image-20251103223419433

启动项目，打开Scalar，可以看到api/orders/cancel接口已被弃用

image-20251103223542587

3.5配置`API`版本描述(`ApplyApiVersionDescription`)#

给每个操作的 api-version 参数添加描述信息，提供示例值（如 v1 → “1.0”, v2 → “2.0”），帮助调用者知道如何在 URL 或 Header 中传递版本号。

image-20251103210545646

查看ApplyApiVersionDescription具体实现：配置版本描述，区分显示了版本号

image-20251103210824832

启动项目，打开Scalar，选择接口api/orders/cancel，Query Parameters下显示版本信息

image-20251103210953760

3.6配置`Schema`的`Nullable` 属性(`ApplySchemaNullableFalse`)#

遍历所有生成的模型（Schema）属性，对非必填字段，将 Nullable 属性设置为 false，避免前端生成可选字段为空时的类型问题。

image-20251104001540378

查看ApplySchemaNullableFalse的具体实现：

schema.Properties不能null
然后遍历schema.Properties
判断schema.Required不包含property.Key(属性名称)
设置property.Key(属性名称)的Nullable为false

代码简单就是不知道这个schema是什么玩意

image-20251104001842203

我对这个schema挺好奇的，一开始不知道上面在遍历什么

我们启动项目，然后打开OpenAPI 规范文档，找到components节点，components下的schemas列表就是我们要遍历的schema，然后代码就清晰了

schema：描述请求或返回实体的数据结构，包括字段、类型、必填/可选、格式等信息。
schema.Properties：定义对象的所有字段及类型。
Type：字段的数据类型
Format：对 Type 的进一步限定，通常表示数据的具体存储或精度方式
Nullable：表示字段是否可以为 null，也就是可空性
schema.Required：列出必填字段的名字数组。
schema.type：表示整个schema 的类型，这里都是 "object"，意味着它是一个对象/DTO。

1
http://localhost:5224/openapi/v1.json

image-20251104002018542

打开Scalar，可以查看nullable标记

为什么CreateOrderRequest好多字段"nullable": true，其他对象都没有这个”nullable”？

CreateOrderRequest 全部字段都是 record 构造函数参数

项目未启用 NRT → 引用类型默认可空 → OpenAPI 自动生成 "nullable": true

而其他 record 或 class 的字段：

不是构造函数参数

或嵌套 record / class

或值类型字段（如 int、DateTime）

OpenAPI 默认省略 nullable

OpenAPI 的 nullable 属性主要由 字段类型 + record 构造函数 + 项目 NRT 设置 决定，构造函数的引用类型在未启用 NRT 时会被标记 "nullable": true"，其他字段默认省略。

image-20251104004821610

3.7配置`Schema`的`Nullable` 属性(`ApplySchemaNullableFalse`)#

OpenAPI 文档中默认会生成 Servers 列表，通常包含项目启动时的本地 URL，清空后，文档不会绑定具体端口，适用于动态端口或服务注册场景（如 Aspire 微服务平台），确保在不同环境下，文档不会显示错误 URL。

image-20251104005609859

通过 servers 设置不同环境地址，Scalar根据选择的 URL 发送请求

我们配置几个不存在的服务器地址

image-20251104010334713

重启项目，再打开Scalar，配置的Url都显示出来了

image-20251104010424300

选择一个get请求接口，然后测试，发现请求地址已经变成勾选的Server了

接口不通没有关系，我们主要看请求地址，授权认证后面再调，测试完记得把document.Servers改回去

image-20251104010558799

3.8配置`Scalar`认证授权(`Implicit`)#

1.配置服务认证授权#

订单服务(Ordering.API)配置了认证授权，所以我们使用Scalar调试接口的时候也需要认证服务(Identity.API)颁发的token，上面的测试就是401无权限

首先我们再回忆下我们认证授权配置了那些：

认证服务(Authority)：我们本地启动的Identity.API，其他服务认证授权配置Identity.API的地址即可。
使用Https协议获取认证中心(Authority )元数据(RequireHttpsMetadata)：原来这里是false，访问不验证https，为了多学习我们设置为true，本身Identity.API启动就是使用的https协议
订阅人(Audience)：确保认证服务Identity.API颁发的token是发给我的(订单服务)，就是我们在appsettings.json中配置"Audience": "orders"。简单理解：什么服务就配置什么服务的标识，但是认证服务同时也要有此标识。确保这个Token 是发给当前 API 的，而不是其他服务。验证签发token的aud。
签发者(Issuers)：确保Token是由受信任的认证中心签发。验证签发token的iss。

image-20251104012258084

还需要再回忆一下认证服务(Identity.API)中的客户端配置，找到orderingswaggerui配置

image-20251104014215886

然后我们启动认证服务，在..\eShop\src\Identity.API目录下运行以下命令：

1
dotnet run --urls https://localhost:5243/

image-20251103193457394

2.配置隐式授权(`Implicit`)#

启动订单服务(Ordering.API)，打开Scalar，然后配置好Client ID和Scopes，之后点击Authorize

image-20251104014612043

提示我们错误的回调地址(Invalid redirect_uri)

image-20251104014913406

再回到认证服务(Identity.API)的Config配置中，简单了解一下隐式授权模式(Implicit Grant Type)

Implicit Flow：
响应类型直接把 access_token（以及可选的 id_token）返回给浏览器。常用于早期的单页应用（SPA）、Swagger UI、Scalar 等纯前端客户端，不需要/也无法安全保存客户端密钥（client secret）。
特点：

不使用客户端密钥（client secret）；

Token 直接通过 URL fragment (#access_token=...) 返回给浏览器；

通常不会返回 refresh_token（为避免长期泄露风险）；

更容易实现，但安全性低于 Authorization Code + PKCE。

所以我们需要配置回调地址，我们配置Scalar的地址，有v1/v2俩个版本的地址：

1
# ehsop没有配置configuration["OrderingApiClient"]，这个返回的是null
2
# 我们要配置完整地址
3
RedirectUris = {
4
    $"{configuration["OrderingApiClient"]}/swagger/oauth2-redirect.html",
5
    $"http://localhost:5224/scalar/v1",
6
    $"http://localhost:5224/scalar/v2"
7
},

image-20251104175844494

配置完回调地址后，再次启动项目，打开Scalar，设置Client ID和Scopes，然后点击Authorize

image-20251104180230495

已经成功获取token，可以点开右边小眼睛图标查看token

image-20251104180349148

点开/api/orders接口测试一下，返现还是返回错误：Bearer error="invalid_token", error_description="The audience 'empty' is invalid"

token中的audience(订阅人)不对

image-20251104180523049

复制获取的token到https://www.jwt.io/中看看

image-20251104180813029

我们在配置AddJwtBearer需要验证签发者(Issuers)和订阅人(Audience)，token中没有订阅人(aud)

image-20251104181038147

知道原因了，就在orders的API服务配置授权范围Scopes

1
new ApiResource("orders", "Orders Service"){
2
 Scopes = { "orders" }
3
}

image-20251104181342028

重新启动认证服务(Identity.API)（有时候需要关闭cmd，重新输入命令启动），再次测试接口，发现请求状态200

image-20251104193242480

通过https://www.jwt.io/解密token，发现已经有了aud

以下几个字段是比较重要的字段，需要留意下：

字段	英文全称	中文解释
iss	Issuer	签发者：表示令牌由谁颁发。这里是授权服务器（IdentityServer）的地址，即 `"https://localhost:5243"`。API 服务会通过它来验证 token 来源是否可信。
aud	Audience	受众（目标服务）：表示这个令牌是发给哪个 API 的。这里是 `"orders"`，说明这个 token 只能访问名为 `orders` 的服务。
scope	Scopes	授权范围：描述 token 拥有哪些访问权限。这里只有 `"orders"`，即允许访问订单服务对应的资源。
client_id	Client Identifier	客户端 ID：标识是谁请求了这个 token。这里是 `"orderingswaggerui"`，说明是 Swagger UI 这个客户端发起的授权请求。
sub	Subject	用户唯一标识：表示这个 token 属于哪个用户。通常是用户 ID（GUID）。例如 `"473aebe2-7d91-4d99-a4e0-3fcfd0764061"`。

1
{
2
  "iss": "https://localhost:5243",
3
  "aud": "orders",
4
  "scope": [
5
    "orders"
6
  ],
7
 "client_id": "orderingswaggerui",
8
 "sub": "473aebe2-7d91-4d99-a4e0-3fcfd0764061"
9
}

image-20251104193342136

有时候没有登录，是因为IdentityServer的Cookie缓存时间较长，可以主动清除Cookie缓存（鼠标右键）

image-20251104205558593

但是IdentityServer弹窗没有弹出授权，这就需要我们在配置RequireConsent

1
 RequireConsent = true,      // 强制用户在授权页面确认 scope
2
 RequirePkce = true,         // 可选，增加安全性，SPA推荐开启

image-20251104205747481

清除Cookie缓存（鼠标右键）

image-20251104210006799

重新启动认证服务(Identity.API)，再次Authorize时，输入完用户密码就需要授权Scope

image-20251104210154198

3.隐式授权流程(`Implicit`)#

首先查看OpenAPI 规范（Scalar 用）中 OAuth2 安全认证机制的定义：本 API(订单服务) 使用 OAuth2 的隐式授权模式，通过认证服务器 https://localhost:5243 登录获取访问令牌，以访问 orders 资源范围的受保护接口。

image-20251104194434005

关闭认证服务(Identity.API)，然后再次点击authorize，我们查看Scalar如何请求认证服务(Identity.API)的

1
# redirect_uri加密了
2
https://localhost:5243/connect/authorize?response_type=token&redirect_uri=http%3A%2F%2Flocalhost%3A5224%2Fscalar%2Fv1&client_id=orderingswaggerui&state=7b7rbpap&scope=orders
3

4
# 解密后
5
https://localhost:5243/connect/authorize?response_type=token&redirect_uri=http://localhost:5224/scalar/v1&client_id=orderingswaggerui&state=7b7rbpap&scope=orders

点击 “Authorize”，Scalar 弹出一个授权窗口，引导浏览器跳转到IdentityServer的授权端点

参数说明：

参数	说明
`response_type=token`	表示使用隐式模式（直接要 access_token）
`client_id`	注册的客户端 ID（例如 orderingswaggerui）
`redirect_uri`	授权完成后的回调地址（必须与配置匹配）
`scope`	要申请访问的 API 权限（如 orders）
`state`	防止 CSRF 攻击的随机值

image-20251104195921715

重新启动认证服务(Identity.API)，设置Client ID和Scopes，然后点击Authorize，弹出IdentityServer进行登录

image-20251104205133235

认证服务(Identity.API)不好调试流程，可以查看日志了解认证授权的流程：没有登录前，User is not authenticated(用户未认证)

image-20251104232753239

登录成功后，跳转到授权页面，显示Showing consent: User has not yet consented(正在显示授权同意页面，因为这个用户还没有同意让这个客户端访问他的信息。)

image-20251104232856396

授权完成后，这段日志的意思是：用户（13051f3a-c540-4f64-8048-b141d7a3e026）已授权客户端 orderingswaggerui 访问 orders 资源，并且记住了授权

SubjectId：当前登录用户的唯一标识（数据库里 AspNetUsers 表的 Id）。
ClientId：请求授权的客户端，即 orderingswaggerui（Swagger UI）。
RequestedScopes：客户端请求访问的资源范围，这里是 "orders"。
GrantedScopes：最终同意授权的范围（同上）。
ConsentRemembered = true：表示用户点击了“记住我的授权”，以后不会再弹出“同意授权”页面。
EventType = Information：普通信息事件。

image-20251104233235079

这一段日志的含义：

客户端（Scalar）在用户同意后，IdentityServer现在调用 /connect/authorize/callback 来处理授权回调。也就是把用户授权结果重定向（redirect）回客户端。
IdentityServer 需要加载用户的详细信息（例如 Email、用户名、状态等），所以它从数据库查出了这位用户的记录。
用户最终同意了访问 orders 范围。

image-20251104233732689

IdentityServer 已成功签发access_token给客户端 orderingswaggerui：

GrantType：使用的授权模式是 implicit（隐式授权）。
RedirectUri：授权成功后重定向到客户端（Swagger UI）的回调地址。
Tokens：生成了一个访问令牌（access_token）。
EventType = Success：代表令牌签发成功。

image-20251104233850653

登录授权成功后，IdentityServer弹窗自动关闭，Scalar获取到token

image-20251104205316588

流程说明

步骤	Implicit Flow
1	用户点击 Authorize
2	跳转 IdentityServer 登录
3	如果未登录 → 输入用户名/密码
4	用户同意授权
5	Scalar 获取 token
6	使用 token 调用 API

4.配置授权码模式(`Authorization Code + PKCE`)#

隐式模式(Implicit)已经被淘汰了，eShop 官方示例用 Implicit，是为了演示方便（快速看到授权效果），让 Swagger UI（或浏览器）/Scalar能够直接拿到 Access Token，方便开发和测试。

在 OAuth 2.1 规范中（2023 年正式发布），Implicit 模式已被标记为弃用：

Access Token 暴露在 URL；
无法安全刷新；
浏览器中易被脚本窃取；
无法防止中间人攻击。

所以现代标准中 强制推荐改用 Authorization Code + PKCE。

既然学习，我们也看看授权码模式(Authorization Code + PKCE)，我们就以购物车服务(Basket.API)为例，因为购物车的Scalar也是我们为了学习加上的，购物车服务(Basket.API)因为使用了Grpc，所以只能使用https协议，我们把接口也加上了api版本

image-20251104235344290

先添加以下配置：

1
 // 授权类型：Authorization Code + PKCE
2
 AllowedGrantTypes = GrantTypes.Code,
3
 // SPA/Scalar 客户端不保存 secret，所以不要求 client_secret
4
 RequireClientSecret = false,
5
 // 强制使用 PKCE（安全性必须）
6
 RequirePkce = true,
7
 // 是否显示用户同意授权页面
8
 RequireConsent = true, // 强制每次授权确认
9
 // token 生命周期和刷新控制（可选）
10
 AllowOfflineAccess = false, // 如果暂时不需要 refresh token
11
 // 允许跨域请求的 origin
12
 AllowedCorsOrigins =
13
 {
14
   "https://localhost:5221"  // Scalar / Swagger UI 所在的域名
15
 },

展开收起

为什么授权码模式(Authorization Code + PKCE)会触发跨域？隐式模式(Implicit )不需要（这是我调试过程遇到的问题，我提前记录一下）
在 Implicit 流 下：

浏览器通过 302 重定向 + URL fragment 获取 token

不走 JS Ajax，所以不会触发 CORS

在 Authorization Code + PKCE 下：

前端 SPA 需要用 JS 通过 POST /connect/token 来交换 code → access_token

浏览器 JS 发起的是跨域 AJAX 请求

IdentityServer 如果没有允许该 Origin，就报 CorsPolicyService did not allow origin: ...

image-20251105000220581

然后配置回调地址(RedirectUris)和允许访问的的API范围(AllowedScopes)

为什么需要配置 RedirectUris？

OAuth2 / OIDC 协议要求每个客户端注册 回调地址（redirect_uri）。

当用户在 IdentityServer 授权成功后，浏览器会重定向到这个地址，并带上 code 或 token。

严格匹配：IdentityServer 会检查请求中的 redirect_uri 是否在客户端注册列表里，否则会报：Invalid redirect_uri

为什么还要配置 openid / profile scopes？
这些 scope 来自 OpenID Connect (OIDC) 协议：

openid → 表示这是一个 OIDC 请求（IdentityServer 会返回 id_token）

profile → 请求用户信息（如名字、头像等）

区别于普通 API scope：

API scope（比如 basket）只控制访问后端 API

openid/profile 用于获取用户身份信息（JWT 中的 claims）

如果你的前端只需要访问 API，不关心用户信息，可以不用 openid/profile，openid/profile 可以根据需要决定是否保留。

image-20251105000716645

定义一个名为 "basket" 的受保护 API，并指定访问它需要 "basket" 这个 scope。

image-20251105001310689

OAuth2新增授权码模式(Authorization Code + PKCE )

image-20251105001538818

RequireAuthorization：给这个 API 分组下的所有端点应用授权策略，也就是需要用户已经登录或具备某些权限才能访问这些接口。

1
var api = vApi.MapGroup("api/Basket").HasApiVersion(1, 0).HasApiVersion(2, 0).RequireAuthorization();

image-20251105003204676

如果配置RequireAuthorization()没有token访问接口返回401（无权限）

image-20251105003342117

所有代码配置完成后，启动购物车服务(Basket.API)，打开Scalar，选择OAuth2，发现多了一种授权方案(Authorization Code)

跟之前一样配置：Client ID、Use PKCE、Scopes

Client Secret 可选

对于 SPA 或前端客户端（比如 Scalar 文档 UI、Swagger UI），不存储密钥是推荐做法，因为前端代码无法安全保管 secret。

所以在IdentityServer中，你可以配置 RequireClientSecret = false。

如果你在 Scalar 上看到 Client Secret: XYZ123，那只是生成的示例，并不是必须的。

PKCE 强制使用 SHA-256

PKCE（Proof Key for Code Exchange）是 Authorization Code 流的增强安全机制，用于前端应用防止授权码被截获。

PKCE 流程里有一个 code_challenge，必须经过 SHA-256 哈希（S256）生成，原始的 plain 方法被现代安全标准弃用。

因此 IdentityServer 会要求 code_challenge_method = S256，不能用 plain，否则报错：code_challenge_method of plain is not allowed

image-20251105001926111

输入用户名和密码，然后点击登录

image-20251105002848800

再点击Yes,Allow(允许授权)

image-20251105002929930

打开/api/Basket/{customerId}，测试一下，查询正常

image-20251105003038439

5.授权码模式流程(`Authorization Code + PKCE`)#

在查看 OpenAPI 规范文档时，我们为 oauth2 安全方案配置了两种授权模式：Implicit 和 Authorization Code，分别对应浏览器直接获取 token 和通过授权码交换 token 的安全流程，并指定了 basket API 的访问范围。

1
https://localhost:5221/openapi/v1.json

image-20251105004034522

先关闭认证服务(Identity.API)，然后设置Client ID、Use PKCE、Scopes，点击Authorize

查看Scalar发起的授权请求：

response_type=code：授权码模式。
scope：请求访问的范围。
code_challenge & code_challenge_method：PKCE，客户端生成随机字符串和散列，服务器用来校验。
redirect_uri：授权成功后回调地址。
state：防 CSRF，同时保持请求上下文
client_id：当前客户端的唯一标识

1
# 原请求
2
https://localhost:5243/connect/authorize?response_type=code&code_challenge=3_V716AyAbS7uKOkhK6jDTW7Ho8As2_zq6EOBA_i7jQ&code_challenge_method=S256&redirect_uri=https%3A%2F%2Flocalhost%3A5221%2Fscalar%2Fv1&client_id=basketswaggerui&state=78jzgb2i&scope=basket
3
# 解码后 redirect_uri加密了
4
https://localhost:5243/connect/authorize?
5
response_type=code&
6
code_challenge=3_V716AyAbS7uKOkhK6jDTW7Ho8As2_zq6EOBA_i7jQ&
7
code_challenge_method=S256&
8
redirect_uri=https://localhost:5221/scalar/v1&
9
client_id=basketswaggerui&
10
state=78jzgb2i&
11
scope=basket

image-20251105004502293

启动认证服务(Identity.API)和购物车服务(Basket.API)，设置Client ID、Use PKCE、Scopes，点击Authorize

没登录前：Showing login: User is not authenticated（显示登录页，用户没有认证）

image-20251105005336634

登陆成功后：Showing consent: User has not yet consented（显示授权：用户未授权）

image-20251105005723209

client_id：客户端唯一标识
redirect_uri：回调地址，必须匹配注册信息
code：授权码，用于换取 Access Token
grant_type：授权模式，这里是授权码模式(authorization_code)
code_verifier：PKCE 验证码，保证授权码安全

1
POST https://localhost:5243/connect/token
2
client_id=basketswaggerui&
3
redirect_uri=https%3A%2F%2Flocalhost%3A5221%2Fscalar%2Fv1&
4
code=32BAD9BF9537F37C142CAC44066BFC80F5A81DDBB61B74E06445FA61881D0A85-1&
5
grant_type=authorization_code&
6
code_verifier=5JddRWZjBe72ixVPwZMxIQblPyhe_MivmcNUQFa2LEI

为什么授权码模式(Authorization Code + PKCE)会触发跨域？隐式模式(Implicit )不需要（这是我调试过程遇到的问题，我提前记录一下）
上面记录了这个问题，就是因为Scalar客户端发起了Ajax请求获取token，所以认证服务(Identity.API)需要配置AllowedCorsOrigins

image-20251105005842494

Scalar设置Access Token，所有api调用就可以使用这个Access Token

image-20251105010600233

SPA/Scalar 通常不使用 Refresh Token，是因为浏览器无法安全存储长期凭证，短期 Access Token + PKCE 重新授权比使用 Refresh Token 更安全。

image-20251105010745695

流程说明

步骤	Authorization Code + PKCE Flow
1	用户点击 Authorize
2	跳转 IdentityServer 登录
3	如果未登录 → 输入用户名/密码
4	用户同意授权
5	IdentityServer 重定向回客户端（带授权码 code）
6	客户端使用 code + code_verifier 向 IdentityServer Token Endpoint 交换 Access Token
7	IdentityServer 返回 Access Token（可选 ID Token）
8	客户端使用 Access Token 调用受保护 API

3.9配置请求`Header`中`requestid`#

订单服务(Ordering.API)作为核心服务，对于一些比较重要的命令请求时必须在Header中加上x-requestid，用于保证相同 x-requestid 的请求只执行一次。

我们需要在Scalar文档上给x-requestid加上默认值，这个需求是我为了方便自己加上的，和eshop无关

image-20251105181131529

获取Header的x-requestid，然后赋值Guid.NewGuid().ToString()

image-20251105181538864

Scalar中的x-requestid有了默认值，但是这个只是在OpenAPI 文档生成的时候设置的默认值，没法在每次请求的时候自动设置x-requestid默认值

image-20251105181716338

3.10启用`OpenAPI`/`Scalar`#

在 开发环境下自动启用 Swagger/OpenAPI 文档，并提供 Scalar 可视化文档，同时把根路径 / 指向 Scalar 文档首页。

image-20251105011502960

📌 创作不易，感谢支持！

每一篇内容都凝聚了心血与热情，如果我的内容对您有帮助，欢迎请我喝杯咖啡☕，您的支持是我持续分享的最大动力！

💬 加入交流群（QQ群）：576434538

NAS闲置？TVBox无源？这个120K+星项目，一个链接拯救你的电视体验

2026-06-17T00:00:00.000Z

朋友们！看电视怎么这么难？#

你是不是每天都要面对这些困扰：

家庭电视高清要会员：想看高清直播？对不起，先充个会员吧！央视、卫视、体育频道……每个都要单独付费，一个月下来好几百块
有NAS却无有效源：花大价钱买了NAS，想搭建家庭媒体中心，结果到处找IPTV源，不是失效就是卡顿，根本用不起来
TVBox等软件无有效源：安装了TVBox、Kodi这些播放器，结果源地址三天两头失效，好不容易找到的源，过几天就404了
无法随时随地看电视：家里有电视，出门想看怎么办？手机、平板、电脑……每个设备都要重新配置，太麻烦了

今天我要给大家分享一个 GitHub 上的宝藏项目——IPTV-ORG！这个项目汇聚了全球 12000+ 免费电视频道，央视、卫视、BBC、CNN、NHK……一个链接全部搞定！

✨ 什么是 IPTV-ORG？#

IPTV-ORG 是一个由全球志愿者共同维护的免费 IPTV 直播源集合。它不提供视频内容，而是收集整理了全球各地公开可用的电视直播源，以 M3U 播放列表的形式提供给大家。

核心特点：

📺 12000+ 频道：覆盖全球 220+ 国家和地区
🌐 190+ 语言：支持中文、英文、日语、韩语等多种语言
🆓 完全免费：无需注册、无需付费、无广告
🔄 社区维护：志愿者持续更新，每天自动检测
📱 跨平台：支持电脑、手机、电视盒子等所有设备

🎯 频道分类#

按地区分类#

地区	频道数量	代表频道
中国大陆	800+	央视全系列、各大卫视、地方台
中国港澳台	100+	香港TVB、台湾中天、澳门澳视
美国	700+	CNN、BBC America、ESPN、HBO
英国	200+	BBC全系列、ITV、Channel 4
日本	150+	NHK、富士电视台、东京电视台
韩国	100+	KBS、SBS、MBC
其他地区	8000+	全球各国本地频道

按类型分类#

类型	频道数量	说明
新闻	215	全球新闻频道
体育	110	ESPN、FOX Sports 等
电影	50	电影频道
音乐	133	MTV、音乐台
儿童	42	卡通频道、少儿节目
纪录片	10	Discovery、国家地理
娱乐	59	综艺节目、真人秀
宗教	177	宗教频道

🚀 使用方法#

第一步：获取播放列表#

项目提供了多种播放列表，您可以根据需求选择：

1
# 全部频道（推荐）
2
https://iptv-org.github.io/iptv/index.m3u
3

4
# 按国家分类
5
https://iptv-org.github.io/iptv/index.country.m3u
6

7
# 按语言分类
8
https://iptv-org.github.io/iptv/index.language.m3u
9

10
# 按类型分类
11
https://iptv-org.github.io/iptv/index.category.m3u
12

13
# 仅中国大陆频道
14
https://iptv-org.github.io/iptv/countries/cn.m3u
15

16
# 仅新闻频道
17
https://iptv-org.github.io/iptv/categories/news.m3u

展开收起

第二步：选择播放器#

平台	推荐播放器	特点
Windows	PotPlayer / VLC	功能强大，支持格式多
macOS	IINA / VLC	界面美观，性能优秀
Linux	VLC	开源免费，全平台支持
Android	nPlayer / VLC	手机端体验好
iOS	nPlayer	支持网络串流
电视盒子	Kodi / TiviMate	机顶盒专用

第三步：配置播放列表#

以 VLC 为例：

打开 VLC 播放器
点击菜单：媒体 → 打开网络串流（快捷键：Ctrl+N）
粘贴播放列表 URL
点击 播放，等待加载频道列表
在左侧播放列表中选择频道观看

以 Kodi 为例：

安装 PVR IPTV Simple Client 插件
打开插件配置
选择 M3U Play List URL
输入播放列表地址
重启 Kodi，即可在电视菜单中看到频道

优点#

频道丰富：央视 1-17 套全齐，各大卫视秒开，港澳台频道也能看
完全免费：没有广告、没有弹窗、没有开屏等待
跨平台：同一个链接，电脑、手机、电视盒子都能用
社区活跃：每天自动检测失效源，持续更新

缺点#

稳定性一般：部分频道会失效，尤其是境外频道
画质参差不齐：有的 1080p，有的只有 480p
部分境外频道有地域限制：需要 VPN 才能观看

⚠️ 重要提醒#

关于版权#

项目收录的都是公开可用的免费频道，不涉及盗版内容
请尊重版权，对于需要付费的内容（如体育赛事、付费电影），建议支持正版
使用前请确认当地法律法规

安全建议#

只使用官方提供的播放列表链接，不要下载不明来源的文件
建议使用正规播放器，避免安装盗版软件
境外频道可能需要 VPN，选择可靠的 VPN 服务

📝 使用技巧#

技巧一：使用精简版列表#

如果觉得全量列表太大，可以使用分类列表：

1
# 仅看新闻
2
https://iptv-org.github.io/iptv/categories/news.m3u
3

4
# 仅看体育
5
https://iptv-org.github.io/iptv/categories/sport.m3u
6

7
# 仅看儿童频道
8
https://iptv-org.github.io/iptv/categories/kids.m3u

技巧二：本地缓存播放列表#

将 M3U 文件下载到本地，避免每次都从网络加载：

Terminal window

1
# Windows
2
curl -o iptv.m3u https://iptv-org.github.io/iptv/index.m3u
3

4
# macOS/Linux
5
wget https://iptv-org.github.io/iptv/index.m3u

技巧三：自定义播放列表#

如果官方列表中有不喜欢的频道，可以下载后手动编辑 M3U 文件，删除不需要的频道。

📝 总结#

IPTV-ORG 是一个非常棒的开源项目，它让我们可以免费观看全球数千个电视频道。虽然稳定性和画质不如付费方案，但胜在完全免费、频道丰富、跨平台支持。如果你不想为电视会员花钱，或者想看看境外频道，这个项目绝对值得一试！

🌟 项目资源#

GitHub 地址: https://github.com/iptv-org/iptv

官方网站: https://iptv-org.github.io/iptv/

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你平时用什么看直播？最想看什么频道？欢迎在评论区和我交流分享！

我会定期分享更多好用的工具，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

Microsoft 放大招！Intelligent Terminal 来了：AI 加持的命令行神器

2026-06-16T00:00:00.000Z

朋友们！命令行也要被 AI 占领了？#

作为开发者，每天都要和终端打交道。写脚本、跑构建、部署应用…命令行是我们最常用的工具之一。但是，你有没有遇到过这些困扰：

记不住复杂的命令参数？
命令执行出错不知道怎么修复？
想要自动化一些重复操作却不会写脚本？
在多个命令之间切换时上下文丢失？

就在最近的 Microsoft Build 2026 大会上，微软发布了一个重磅项目——Intelligent Terminal！这是一款集成了 AI 代理的智能终端，让你的命令行体验彻底升级！今天就来给大家详细介绍这个神器！

✨ 什么是 Intelligent Terminal？#

Intelligent Terminal 是 Windows Terminal 的开源分支，由微软官方推出。它在保留 Windows Terminal 所有功能的基础上，引入了原生 AI 代理集成，让开发者可以在命令行中获得 AI 助手的帮助。

核心特点：

🔧 完全独立：不替换现有 Windows Terminal，作为独立应用安装
🤖 AI 代理集成：原生支持多个 AI 服务提供商
🔒 隐私优先：所有 AI 功能严格可选（Opt-in），终端本身不做云端调用
📖 开源免费：MIT 许可证，代码完全开放

🎯 核心功能#

1. AI 代理面板#

按下 Ctrl+Shift+. 即可打开 AI 代理面板，直接在终端中与 AI 助手对话：

命令解释：输入命令，AI 帮你解释每个参数的含义
错误诊断：命令执行失败时，AI 自动分析错误并给出修复建议
脚本生成：描述你想做的事情，AI 帮你生成对应的命令或脚本
上下文感知：AI 可以看到当前终端的上下文和历史记录

2. 多 AI 提供商支持#

Intelligent Terminal 支持多种 AI 服务提供商，通过 Agent Client Protocol 通信：

AI 提供商	状态
GitHub Copilot	默认支持
Claude Code	✅ 支持
OpenAI Codex	✅ 支持
Google Gemini	✅ 支持

终端会自动检测你已安装的 AI 代理，无需手动配置。

3. 智能错误检测#

当命令执行失败时，终端会自动检测错误，并提供一键加载上下文的功能，让 AI 代理能够看到刚刚发生的错误并给出针对性的解决方案。

4. 后台任务支持#

AI 代理可以在后台标签页中执行长时间任务，比如构建项目、运行测试等，而你可以在其他标签页继续工作，互不干扰。

5. 插件生态系统#

Intelligent Terminal 支持插件扩展，开发者可以编写自定义 AI 代理或工具，扩展终端的功能。

🔧 技术架构#

1
┌─────────────────────────────────────────────────────────────┐
2
│                   Intelligent Terminal                       │
3
├─────────────────────────────────────────────────────────────┤
4
│  ┌──────────────┐    ┌──────────────────────┐              │
5
│  │   Terminal   │    │    AI Agent Panel    │              │
6
│  │  (核心界面)   │    │    (Ctrl+Shift+.)   │              │
7
│  └──────┬───────┘    └──────────┬───────────┘              │
8
│         │                       │                          │
9
│         └───────────┬───────────┘                          │
10
│                     ▼                                      │
11
│         ┌──────────────────────┐                           │
12
│         │   Agent Client       │                           │
13
│         │    Protocol          │                           │
14
│         │   (JSON-RPC 2.0)     │                           │
15
│         └──────────┬───────────┘                           │
16
│                    │                                       │
17
│     ┌──────────────┼──────────────┐                        │
18
│     ▼              ▼              ▼                        │
19
│ ┌─────────┐   ┌─────────┐   ┌─────────┐                    │
20
│ │Copilot  │   │Claude   │   │Gemini   │                    │
21
│ │  CLI    │   │  Code   │   │         │                    │
22
│ └─────────┘   └─────────┘   └─────────┘                    │
23
└─────────────────────────────────────────────────────────────┘

展开收起

关键技术点：

使用 Agent Client Protocol 进行通信
通过 JSON-RPC 2.0 协议与 AI 代理交互
终端本身不做云端调用，所有数据由用户选择的 AI 代理处理
支持超过 25 种兼容协议的 AI 代理

🚀 安装教程#

方法一：Microsoft Store（推荐）#

打开 Microsoft Store
搜索 “Intelligent Terminal”
点击安装

方法二：winget#

Terminal window

1
winget install Microsoft.IntelligentTerminal

方法三：GitHub 下载#

访问 GitHub 发布页：https://github.com/microsoft/intelligent-terminal/releases
下载最新版本的安装包
运行安装程序

系统要求#

Windows 11 build 22621.6060 或更高版本
需要 AI 服务提供商订阅（GitHub Copilot、Azure OpenAI、OpenAI 等）

📝 使用指南#

快速开始#

打开 Intelligent Terminal
按下 Ctrl+Shift+. 打开 AI 代理面板
输入你的问题，比如：“帮我写一个 git commit 命令”
AI 会给出相应的命令建议

实际场景演示#

场景一：命令解释#

Terminal window

1
# 输入
2
解释一下 git push --force 的作用
3

4
# AI 回答
5
git push --force 用于强制推送本地分支到远程仓库，会覆盖远程分支的历史记录。
6
⚠️ 警告：此命令可能会导致远程分支的数据丢失，请谨慎使用。
7
推荐使用 git push --force-with-lease 替代，它会先检查远程分支是否有新的提交。

场景二：错误诊断#

Terminal window展开收起

1
# 执行失败的命令
2
dotnet build
3

4
# AI 自动检测到错误并给出建议
5
Copilot v1.0.55-7
6

7
> Auto-diagnosed a recent command failure
8
[Viewing ...rs\mousma\Documents\ContosoApp\MainPage.xaml.cs] Completed
9

10
Suggested 1 option:
11
√ 1. Run: (Get-Content C:\Users\mousma\Documents\ContosoApp\MainPage.xaml.cs) -replace 'this\.UpdateLayout\(\)$', 'this.UpdateLayout();' | Set-Content C:\Users\mousma\Documents\ContosoApp\MainPage.xaml.cs
12

13
命令文本：
14
(Get-Content C:\Users\mousma\Documents\ContosoApp\MainPage.xaml.cs) -replace 'this\.UpdateLayout\(\)$', 'this.UpdateLayout();' | Set-Content C:\Users\mousma\Documents\ContosoApp\MainPage.xaml.cs
15

16
[ Run command ]  Insert in Terminal
17

18
快捷键提示：
19
(Ctrl+Shift+. to show/hide agent pane • Ctrl+Shift+/ to show/hide agent session)
20
(↑ ↓ to navigate suggestions • ← → to switch actions • Enter to select • Esc to cancel)
21

22
输入框提示：
23
> Ask anything, / for commands..

展开收起

场景三：脚本生成#

Terminal window

1
# 输入
2
帮我生成一个脚本，统计当前目录下的文件数量
3

4
# AI 生成脚本
5
Get-ChildItem -Path . -File | Measure-Object | Select-Object -ExpandProperty Count

配置 AI 服务提供商#

打开终端设置（Ctrl+,）
选择 “AI Agent” 选项卡
选择你想要使用的 AI 服务提供商
按照提示进行身份验证或配置

📝 总结#

Microsoft Intelligent Terminal 是微软在 AI 时代对命令行工具的一次重要升级。它通过开放协议和可选 AI 集成的方式，既满足了开发者对 AI 辅助的需求，又保证了隐私和控制。支持多 AI 提供商、智能错误检测、后台任务等功能，让命令行工作更加高效。如果你是 Windows 用户，想要体验 AI 加持的终端，不妨试试这个工具！

🌟 项目资源#

GitHub 地址: https://github.com/microsoft/intelligent-terminal

官方文档: https://learn.microsoft.com/zh-cn/windows/terminal/

最新版本: v0.1

开源协议: MIT License

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你平时使用什么终端工具？最期待 AI 终端带来什么功能？欢迎在评论区和我交流分享！

我会定期分享更多好用的开发工具，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！Twinkle Tray：多显示器亮度调节神器

2026-06-15T00:00:00.000Z

朋友们！多显示器亮度调节太麻烦？#

作为一个多屏工作者，你是不是每天都要面对这些困扰：

Windows 只能调节笔记本屏幕亮度，外接显示器完全不受控制
每次调亮度都要弯腰去按显示器物理按键，麻烦又不精确
多台显示器亮度不一致，眼睛累到不行
晚上工作时想调暗屏幕，却找不到合适的工具

直到我发现了 Twinkle Tray！这个 GitHub 上 6.6k+ Star 的神器，让我彻底告别了手动调节亮度的痛苦！今天就来给大家分享这个宝藏工具！

✨ 什么是 Twinkle Tray？#

Twinkle Tray 是一款专门为 Windows 设计的多显示器亮度控制工具。它通过系统托盘提供直观的亮度调节界面，支持几乎所有 DDC/CI 协议的显示器。

🎯 核心功能#

功能	说明
系统托盘滑块	一键调节所有显示器亮度，1% 精度控制
热键支持	自定义快捷键快速调节，无需打开界面
定时调光	根据时间自动调整亮度，日出日落智能适配
DDC/CI 扩展	支持对比度、音量、输入源切换等高级功能
多语言支持	支持 20+ 种语言，中文界面友好
开机启动	Windows 启动时自动运行，无需手动开启

🎨 界面特色#

Twinkle Tray 最让我喜欢的一点是它的界面设计：

自动适配 Windows 风格：完美融入 Windows 10/11 系统，采用毛玻璃效果
跟随系统主题：自动匹配你的个性化设置（浅色/深色模式）
直观操作：左键点击显示亮度面板，滚轮直接调节

🚀 安装教程#

方法一：包管理器安装（推荐）#

Terminal window

1
# Windows 11 内置包管理器
2
winget install xanderfrangos.twinkletray
3

4
# Chocolatey
5
choco install twinkle-tray
6

7
# Scoop
8
scoop bucket add extras
9
scoop install extras/twinkle-tray

方法二：手动下载#

访问 GitHub 发布页：https://github.com/xanderfrangos/twinkle-tray/releases
下载最新版本的 .exe 安装包
运行安装程序，建议选择”为所有用户安装”

方法三：Microsoft Store#

直接在 Microsoft Store 搜索 “Twinkle Tray” 即可安装。

📝 使用指南#

基础操作#

调节亮度：点击系统托盘的 ✨ 图标，拖动滑块调节
单独控制：每个显示器有独立的亮度滑块
统一调节：拖动顶部的”所有显示器”滑块一起调整

热键配置#

右键点击托盘图标 → 设置 → 热键

推荐配置：

操作	推荐热键
所有显示器亮度+10%	Ctrl+Win+↑
所有显示器亮度-10%	Ctrl+Win+↓
显示器关闭	Ctrl+Shift+F10

定时调光#

在设置的”时间”标签页中，可以配置：

日出日落模式：根据地理位置自动调节
固定时间表：设置时间段和目标亮度
空闲检测：电脑空闲时自动调暗

⚙️ 高级功能#

DDC/CI 扩展控制#

除了亮度，还可以控制：

对比度：调整显示器对比度
音量：控制显示器内置扬声器
输入源：切换 HDMI/DP/USB-C 输入
电源状态：开关显示器

显示器归一化#

如果你的显示器亮度曲线不一致，可以使用”归一化”功能让它们看起来亮度相同。

命令行支持#

Terminal window

1
# 设置所有显示器亮度为 50%
2
twinkle-tray --set-all 50
3

4
# 增加亮度
5
twinkle-tray --increase 10
6

7
# 减少亮度
8
twinkle-tray --decrease 10

💡 使用场景#

场景一：程序员多屏开发#

作为程序员，我通常连接 2-3 台显示器。以前调亮度要一个个按物理按键，现在用 Twinkle Tray 一键搞定，效率提升太多！

场景二：夜间工作#

晚上工作时，自动调光功能可以根据时间逐渐降低亮度，保护眼睛。

场景三：演示场景#

做演示时，可以快速关闭不需要的显示器，或者统一调整所有屏幕亮度。

⚠️ 注意事项#

DDC/CI 支持：确保你的显示器支持 DDC/CI 协议（大多数现代显示器都支持）
显卡驱动：更新显卡驱动到最新版本，AMD 用户需禁用”自定义颜色”
显示器连接：建议使用 HDMI/DP 直连，部分转接器可能不支持

📊 对比其他工具#

工具	价格	平台	核心功能
Twinkle Tray	免费	Windows	亮度、热键、定时
DisplayBuddy	付费	Win/Mac	亮度、对比度、预设
Monitorian	免费	Windows	基础亮度控制
Windows 自带	免费	Windows	仅笔记本屏幕

📝 总结#

Twinkle Tray 是一款非常实用的多显示器亮度控制工具，界面美观、功能全面、完全免费。它解决了 Windows 系统不支持外接显示器亮度调节的痛点，通过 DDC/CI 协议实现精确控制。支持热键、定时调光、命令行等高级功能，适合程序员、设计师等多屏工作者使用。如果你正在为多显示器亮度调节烦恼，不妨试试这个工具！

🌟 项目资源#

GitHub 地址: https://github.com/xanderfrangos/twinkle-tray

官方网站: https://twinkletray.com

最新版本: v1.17.2

开源协议: MIT License

觉得项目不错的话，记得给作者点个 star 支持一下！

🎉 互动时间#

你平时使用几台显示器？最需要的功能是什么？欢迎在评论区和我交流分享！

我会定期分享更多好用的开发工具，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub热门项目！Hoppscotch Docker私有部署实战指南

2026-06-12T00:00:00.000Z

朋友们！API测试工具选对了吗？#

作为开发者，你是不是每天都要和各种 API 打交道？测试接口、调试接口、文档化接口…市面上的 API 测试工具不少，但要么收费太贵，要么数据不安全，要么功能不够用。

作为一个资深开发者，我试过很多工具：Postman 功能强大但收费高，Insomnia 不错但团队协作不方便，curl 太麻烦…直到遇到了 Hoppscotch！这是一个完全开源的 API 开发生态系统，功能媲美 Postman，而且可以私有部署，数据完全可控！

这两天我研究了一下它的 Docker 部署方案，发现部署起来其实很简单。今天我就来手把手教大家如何在自己的服务器上部署 Hoppscotch，打造一个专属的 API 测试平台！

✨ 什么是 Hoppscotch？#

Hoppscotch 是一个开源的 API 开发生态系统，被誉为”开源版 Postman”。它支持 REST、GraphQL、WebSocket、MQTT 等多种协议，提供团队协作、环境变量、前置脚本等强大功能。

🎯 核心功能#

🚀 全协议支持: REST、GraphQL、WebSocket、Server-Sent Events、Socket.IO、MQTT
👥 团队协作: 创建团队、共享集合、角色权限控制
📁 工作空间: 组织个人和团队项目到不同工作空间
🌱 环境变量: 支持多环境配置，方便切换开发/测试/生产环境
📜 前置/后置脚本: 支持 JavaScript 编写测试脚本
🔐 多种认证: Basic Auth、Bearer Token、OAuth 2.0、OIDC
📱 跨平台: Web、桌面应用、CLI 工具

📋 前置准备#

环境要求#

依赖	版本要求	说明
Docker	20+	容器运行环境
Docker Compose	2+	容器编排工具
Node.js	18+	可选，用于开发模式
pnpm	6+	可选，用于开发模式
Git	任意	克隆代码仓库

服务器配置建议#

配置项	最低配置	推荐配置
CPU	2核	4核+
内存	4GB	8GB+
存储	20GB	50GB+
系统	Linux (Ubuntu/Debian/CentOS)	Linux

🚀 部署实战#

方式一：使用官方 AIO 容器（推荐）#

优点: 单容器部署，简单快捷，适合快速体验

1. 创建目录结构#

Terminal window

1
mkdir -p /opt/hoppscotch/data
2
mkdir -p /opt/hoppscotch/config
3
cd /opt/hoppscotch

2. 创建 .env 配置文件#

Terminal window展开收起

1
cat > /opt/hoppscotch/config/.env << 'EOF'
2
#-----------------------Backend Config------------------------------#
3
# Prisma Config - 使用内置SQLite数据库
4
DATABASE_URL=file:./data/db.sqlite
5

6
# 数据加密密钥（32位字符）
7
DATA_ENCRYPTION_KEY=your-32-character-encryption-key-here
8

9
# 允许的来源（根据需要添加你的域名）
10
WHITELISTED_ORIGINS=http://localhost:3000,http://localhost:3100,http://localhost:3170,app://localhost_3200,app://hoppscotch
11

12
#-----------------------Frontend Config------------------------------#
13
# 应用基础URL
14
APP_URL=http://localhost:3000
15

16
# API基础URL
17
API_URL=http://localhost:3170
18

19
#-----------------------Auth Config------------------------------#
20
# JWT密钥（32位字符）
21
JWT_SECRET=your-32-character-jwt-secret-here
22

23
# 密码重置密钥（32位字符）
24
PASSWORD_RESET_SECRET=your-32-character-reset-secret-here
25

26
#-----------------------SMTP Config（可选）------------------------------#
27
# SMTP_HOST=smtp.example.com
28
# SMTP_PORT=587
29
# SMTP_USERNAME=your-email@example.com
30
# SMTP_PASSWORD=your-email-password
31
# SMTP_FROM_NAME=Hoppscotch
32
# SMTP_FROM_EMAIL=no-reply@example.com
33
EOF

展开收起

3. 运行 AIO 容器#

Terminal window

1
docker run -d \
2
  --name hoppscotch-aio \
3
  -p 3000:3000 \
4
  -p 3170:3170 \
5
  -v /opt/hoppscotch/data:/app/data \
6
  -v /opt/hoppscotch/config/.env:/app/.env \
7
  --restart unless-stopped \
8
  hoppscotch/hoppscotch:latest

4. 访问应用#

打开浏览器访问 http://your-server-ip:3000

方式二：使用 Docker Compose 多容器部署（生产推荐）#

优点: 服务分离，便于扩展和维护，适合生产环境

1. 克隆项目代码#

Terminal window

1
git clone https://github.com/hoppscotch/hoppscotch.git
2
cd hoppscotch

2. 创建 .env 配置文件#

Terminal window展开收起

1
cat > .env << 'EOF'
2
#-----------------------Backend Config------------------------------#
3
# PostgreSQL数据库配置
4
DATABASE_URL=postgresql://hoppscotch:hoppscotch@hoppscotch-db:5432/hoppscotch
5

6
# 数据加密密钥（32位字符，必须修改！）
7
DATA_ENCRYPTION_KEY=your-32-character-encryption-key-here
8

9
# 允许的来源
10
WHITELISTED_ORIGINS=http://localhost:3000,http://localhost:3100,http://localhost:3170,app://localhost_3200,app://hoppscotch
11

12
#-----------------------Frontend Config------------------------------#
13
APP_URL=http://localhost:3000
14
API_URL=http://localhost:3170
15

16
#-----------------------Auth Config------------------------------#
17
# JWT密钥（32位字符，必须修改！）
18
JWT_SECRET=your-32-character-jwt-secret-here
19

20
# 密码重置密钥（32位字符，必须修改！）
21
PASSWORD_RESET_SECRET=your-32-character-reset-secret-here
22

23
#-----------------------SMTP Config------------------------------#
24
SMTP_HOST=smtp.example.com
25
SMTP_PORT=587
26
SMTP_USERNAME=your-email@example.com
27
SMTP_PASSWORD=your-email-password
28
SMTP_FROM_NAME=Hoppscotch
29
SMTP_FROM_EMAIL=no-reply@example.com
30

31
#-----------------------OAuth Config（可选）------------------------------#
32
# GitHub OAuth
33
# GITHUB_CLIENT_ID=your-github-client-id
34
# GITHUB_CLIENT_SECRET=your-github-client-secret
35

36
# Google OAuth
37
# GOOGLE_CLIENT_ID=your-google-client-id
38
# GOOGLE_CLIENT_SECRET=your-google-client-secret
39

40
# Microsoft OAuth
41
# MICROSOFT_CLIENT_ID=your-microsoft-client-id
42
# MICROSOFT_CLIENT_SECRET=your-microsoft-client-secret
43
EOF

展开收起

3. 创建 docker-compose.yml#

1
version: '3.8'
2

3
services:
4
  hoppscotch-db:
5
    image: postgres:15-alpine
6
    container_name: hoppscotch-db
7
    environment:
8
      POSTGRES_USER: hoppscotch
9
      POSTGRES_PASSWORD: hoppscotch
10
      POSTGRES_DB: hoppscotch
11
    volumes:
12
      - hoppscotch-db-data:/var/lib/postgresql/data
13
    networks:
14
      - hoppscotch-network
15
    restart: unless-stopped
16

17
  hoppscotch-backend:
18
    image: hoppscotch/hoppscotch-backend:latest
19
    container_name: hoppscotch-backend
20
    depends_on:
21
      - hoppscotch-db
22
    environment:
23
      DATABASE_URL: postgresql://hoppscotch:hoppscotch@hoppscotch-db:5432/hoppscotch
24
      DATA_ENCRYPTION_KEY: ${DATA_ENCRYPTION_KEY}
25
      WHITELISTED_ORIGINS: ${WHITELISTED_ORIGINS}
26
      JWT_SECRET: ${JWT_SECRET}
27
      PASSWORD_RESET_SECRET: ${PASSWORD_RESET_SECRET}
28
      SMTP_HOST: ${SMTP_HOST}
29
      SMTP_PORT: ${SMTP_PORT}
30
      SMTP_USERNAME: ${SMTP_USERNAME}
31
      SMTP_PASSWORD: ${SMTP_PASSWORD}
32
      SMTP_FROM_NAME: ${SMTP_FROM_NAME}
33
      SMTP_FROM_EMAIL: ${SMTP_FROM_EMAIL}
34
    volumes:
35
      - ./config:/app/config
36
    networks:
37
      - hoppscotch-network
38
    restart: unless-stopped
39
    ports:
40
      - "3170:3170"
41

42
  hoppscotch-frontend:
43
    image: hoppscotch/hoppscotch-frontend:latest
44
    container_name: hoppscotch-frontend
45
    depends_on:
46
      - hoppscotch-backend
47
    environment:
48
      APP_URL: ${APP_URL}
49
      API_URL: ${API_URL}
50
    networks:
51
      - hoppscotch-network
52
    restart: unless-stopped
53
    ports:
54
      - "3000:3000"
55

56
  hoppscotch-admin:
57
    image: hoppscotch/hoppscotch-admin:latest
58
    container_name: hoppscotch-admin
59
    depends_on:
60
      - hoppscotch-backend
61
    environment:
62
      VITE_API_URL: ${API_URL}
63
    networks:
64
      - hoppscotch-network
65
    restart: unless-stopped
66
    ports:
67
      - "3100:3100"
68

69
volumes:
70
  hoppscotch-db-data: ./hoppscotch-db-data
71

72
networks:
73
  hoppscotch-network:
74
    driver: bridge

展开收起

4. 启动服务#

Terminal window

1
# 启动所有服务
2
docker-compose up -d
3

4
# 查看服务状态
5
docker-compose ps
6

7
# 查看日志
8
docker-compose logs -f

5. 初始化数据库#

Terminal window

1
# 进入后端容器
2
docker exec -it hoppscotch-backend sh
3

4
# 运行数据库迁移
5
pnpm prisma migrate deploy
6

7
# 退出容器
8
exit

6. 访问应用#

服务	地址	说明
主应用	http://localhost:3000	API测试主界面
管理后台	http://localhost:3100	管理员仪表盘
API服务	http://localhost:3170	后端API

⚙️ 高级配置#

1. 配置 OAuth 登录#

GitHub OAuth#

Terminal window

1
# 在 GitHub 创建 OAuth App: https://github.com/settings/developers
2
# 回调地址: http://your-domain.com/api/auth/github/callback
3

4
# 修改 .env 文件
5
GITHUB_CLIENT_ID=your-github-client-id
6
GITHUB_CLIENT_SECRET=your-github-client-secret

2. 配置 HTTPS（使用 Nginx 反向代理）#

1
server {
2
    listen 80;
3
    server_name api.example.com;
4
    return 301 https://$server_name$request_uri;
5
}
6

7
server {
8
    listen 443 ssl;
9
    server_name api.example.com;
10

11
    ssl_certificate /path/to/cert.pem;
12
    ssl_certificate_key /path/to/key.pem;
13

14
    location / {
15
        proxy_pass http://localhost:3000;
16
        proxy_set_header Host $host;
17
        proxy_set_header X-Real-IP $remote_addr;
18
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
19
        proxy_set_header X-Forwarded-Proto $scheme;
20
    }
21

22
    location /api/ {
23
        proxy_pass http://localhost:3170/;
24
        proxy_set_header Host $host;
25
        proxy_set_header X-Real-IP $remote_addr;
26
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
27
        proxy_set_header X-Forwarded-Proto $scheme;
28
    }
29

30
    location /admin/ {
31
        proxy_pass http://localhost:3100/;
32
        proxy_set_header Host $host;
33
        proxy_set_header X-Real-IP $remote_addr;
34
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
35
        proxy_set_header X-Forwarded-Proto $scheme;
36
    }
37
}

展开收起

3. 配置 Redis 缓存（可选）#

Terminal window

1
# 添加 Redis 服务到 docker-compose.yml
2
redis:
3
  image: redis:7-alpine
4
  container_name: hoppscotch-redis
5
  volumes:
6
    - hoppscotch-redis-data:/data
7
  networks:
8
    - hoppscotch-network
9
  restart: unless-stopped
10

11
# 修改 .env 文件添加 Redis 配置
12
REDIS_URL=redis://hoppscotch-redis:6379

📝 使用教程#

1. 创建账户#

访问 http://localhost:3000，点击”Sign Up”创建账户：

2. 创建第一个请求#

点击左侧 ”+” 按钮创建新请求
选择 HTTP 方法（GET/POST/PUT/DELETE 等）
输入 API 地址
添加请求头和参数
点击”Send”发送请求

3. 创建集合#

点击左侧”Collections”
点击”New Collection”
命名集合并添加描述
将请求拖入集合中

4. 配置环境变量#

点击右上角环境图标
点击”Manage Environments”
创建新环境并添加变量
在请求中使用 {{变量名}} 引用

5. 团队协作#

点击左侧”Teams”
点击”Create Team”创建团队
邀请成员加入
共享集合和工作空间

🔥 常见问题#

Q1: 容器启动失败怎么办？#

Terminal window

1
# 查看日志
2
docker-compose logs hoppscotch-backend
3

4
# 常见问题：数据库连接失败
5
# 确保数据库服务先启动，检查 DATABASE_URL 是否正确
6

7
# 常见问题：端口被占用
8
# 修改 docker-compose.yml 中的端口映射

Q2: 如何备份数据？#

Terminal window

1
# 备份 PostgreSQL 数据库
2
docker exec -it hoppscotch-db pg_dump -U hoppscotch hoppscotch > backup.sql
3

4
# 恢复数据库
5
docker exec -i hoppscotch-db psql -U hoppscotch hoppscotch < backup.sql

Q3: 如何更新版本？#

Terminal window

1
# 停止服务
2
docker-compose down
3

4
# 拉取最新镜像
5
docker-compose pull
6

7
# 启动服务（会自动运行数据库迁移）
8
docker-compose up -d

Q4: 如何配置邮件通知？#

确保 .env 中的 SMTP 配置正确：

Terminal window

1
SMTP_HOST=smtp.example.com
2
SMTP_PORT=587
3
SMTP_USERNAME=your-email@example.com
4
SMTP_PASSWORD=your-email-password
5
SMTP_FROM_NAME=Hoppscotch
6
SMTP_FROM_EMAIL=no-reply@example.com

📝 总结#

Hoppscotch 是一款开源免费的 API 测试工具，功能媲美 Postman。通过 Docker 容器化部署，我们可以轻松搭建企业级私有 API 测试平台。本文介绍了两种部署方式：AIO 单容器适合快速体验，Docker Compose 多容器适合生产环境。配置上支持 OAuth 认证、SMTP 邮件、环境变量等完整功能，无论是 REST、GraphQL 还是 WebSocket 调试，都能高效完成。相比商业工具，Hoppscotch 不仅免费，还支持私有部署，数据安全可控，是团队协作的理想选择。感兴趣的小伙伴可以按照文中步骤实践，根据需求调整配置。今天的分享就到这里，我们下一篇文章见。

🌟 项目资源#

GitHub 地址: https://github.com/hoppscotch/hoppscotch

官方文档: https://docs.hoppscotch.io

官方网站: https://hoppscotch.io

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 开源免费、功能强大、支持多协议、团队协作、私有部署，是企业级 API 测试的首选工具！

🎉 互动时间#

你平时用什么工具测试 API？对 Hoppscotch 有什么期待？欢迎在评论区和我交流分享！

我会定期分享更多好用的开发工具和部署教程，记得关注我哦！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

82万星！AI全自动做短视频/图文，躺平变现！

2026-06-09T00:00:00.000Z

朋友们！做短视频太累的看过来！#

想做短视频变现却被写文案、找素材、剪辑搞到崩溃？一条视频要花几小时，播放量还惨不忍睹？直到我发现了 MoneyPrinterTurbo——GitHub 82万星爆款神器！输入关键词，AI 全自动生成完整短视频，几分钟搞定，质量还超高！今天就带大家看看这个”躺平变现”神器。

✨ 什么是 MoneyPrinterTurbo？#

MoneyPrinterTurbo 是一个基于 AI 的全自动短视频生成工具。只需提供一个视频主题或关键词，它就能自动完成视频文案撰写、视频素材搜索、字幕生成、背景音乐添加，最后合成一个高清的短视频。

🎯 核心特性#

🚀 一键生成: 输入主题关键词，AI 全自动生成完整视频
📝 智能文案: 支持 AI 自动生成文案，也可自定义编辑
📹 多尺寸支持: 竖屏 9<16>（1080x1920）、横屏 16<9>（1920x1080）
🔄 批量生成: 一次生成多个视频，选择最满意的发布
🗣️ 多语音合成: 支持多种语音，可实时试听效果
📜 智能字幕: 自动生成字幕，支持调整字体、位置、颜色、描边
🎵 背景音乐: 随机或指定音乐，可调节音量
🖼️ 高清素材: 无版权高清视频素材，也支持本地素材
🤖 多模型支持: 支持 OpenAI、Claude、Gemini、DeepSeek、通义千问等 700+ 模型

🛠️ 技术栈#

核心框架#

前端: Streamlit（Web 界面）+ FastAPI（API 接口）
后端: Python 3.11
视频处理: MoviePy 2.x
字幕生成: Edge TTS / faster-whisper

AI 模型支持#

类型	支持平台
LLM	OpenAI、AIHubMix、Moonshot、Azure、gpt4free、one-api、通义千问、Google Gemini、Ollama、DeepSeek、MiniMax、文心一言、Pollinations、ModelScope
TTS	Edge TTS（免费）、Azure TTS V2（付费）
字幕	Edge TTS、faster-whisper

📦 安装方式#

Windows 一键启动包（推荐）#

下载一键启动包，解压直接使用：

1
下载地址：
2
- 百度网盘：https://pan.baidu.com/s/1wg0UaIyXpO3SqIpaq790SQ?pwd=sbqx
3
- Google Drive：https://drive.google.com/file/d/1HsbzfT7XunkrCrHw5ncUjFX8XX4zAuUh/view
4
- GitHub release：https://github.com/harry0703/MoneyPrinterTurbo/releases/tag/v1.2.9

使用步骤：

下载并解压（路径不要有中文、特殊字符、空格）
双击 update.bat 更新到最新版本
双击 start.bat 启动，自动打开浏览器

Docker 部署#

Terminal window

1
git clone https://github.com/harry0703/MoneyPrinterTurbo.git
2
cd MoneyPrinterTurbo
3
docker-compose up

访问地址：

Web 界面：http://127.0.0.1:8501
API 文档：http://127.0.0.1:8080/docs

🎬 使用教程#

步骤1：启动应用#

启动后会自动打开 Web 界面，界面简洁直观：

步骤2：配置参数#

在左侧配置面板设置：

视频标题: 输入主题关键词（如”如何增加生活的乐趣”）
视频尺寸: 选择竖屏（9<16>）或横屏（16<9>）
语音选择: 选择喜欢的声音类型
背景音乐: 选择或上传背景音乐
字幕设置: 设置字体、颜色、大小、描边

步骤3：生成视频#

点击「生成视频」按钮，等待几分钟：

1
生成流程：
2
1. AI 生成视频文案
3
2. 搜索匹配的视频素材
4
3. 合成语音旁白
5
4. 生成字幕
6
5. 添加背景音乐
7
6. 合成完整视频

步骤4：预览和导出#

生成完成后可以预览效果，满意后点击下载即可：

🔥 我的使用感受#

作为一个曾经被短视频创作折磨过的人，我必须说 MoneyPrinterTurbo 彻底改变了我的创作方式！

以前做一条视频，从构思到发布至少要几个小时，现在输入一个关键词，几分钟就能得到一个高质量的视频。我试过生成几条关于生活技巧的视频，文案写得很有深度，素材匹配也很精准，字幕和背景音乐搭配得恰到好处。

最让我惊喜的是批量生成功能。输入一个主题，可以一次性生成多个版本，然后选择效果最好的那个发布，大大提高了内容产出效率。

我用它生成的视频在抖音和B站发布，播放量比我以前手动做的还要高！现在每天花半小时就能生成好几条视频，真正实现了”躺平变现”的梦想！

💡 使用场景#

1. 自媒体创作者#

快速产出大量内容
批量生成多个版本测试效果
降低创作门槛和时间成本

2. 企业营销#

快速制作产品宣传视频
批量生成多平台适配视频
降低视频制作成本

3. 教育机构#

自动生成教学视频
批量制作课程内容
提高内容产出效率

4. 个人兴趣#

轻松制作生活记录视频
快速生成知识分享内容
记录生活点滴

📊 配置要求#

配置项	最低配置	推荐配置
CPU	4核	6-8核
内存	4GB	8GB+
GPU	非必需	4GB显存+

小贴士: 如果主要使用云端 LLM 和在线素材，CPU 和内存更重要；如果启用本地 whisper 或批量生成，建议使用带 GPU 的配置。

📝 总结#

MoneyPrinterTurbo 以”AI 驱动 + 自动化流水线”为核心，通过多模型支持与智能素材匹配，实现从主题输入到视频输出的全链路自动化。它支持 700+ AI 模型、多平台部署（Windows一键包、Docker、手动部署）和批量生成，无论是自媒体创作、企业营销还是教育内容，都能通过简单关键词快速产出高质量短视频。相比传统视频制作，效率提升几十倍，真正实现内容创作”躺平变现”。感兴趣的小伙伴可以按文中步骤实践，根据需求调整配置。今天的分享就到这里，我们下一篇文章见。

🌟 项目资源#

GitHub 地址: https://github.com/harry0703/MoneyPrinterTurbo

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: GitHub 82万星爆款，AI全自动生成短视频，支持多模型、多尺寸、批量生成，真正实现内容创作”躺平变现”！

🎉 互动时间#

你是不是已经跃跃欲试了？赶紧去 GitHub 下载体验吧！

你平时做短视频最头疼的是什么？用了 MoneyPrinterTurbo 后有什么感受？欢迎在评论区和我交流分享！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

GitHub 热门项目！DBX，15MB 搞定 40+ 数据库管理！

2026-06-08T00:00:00.000Z

朋友们！数据库管理工具太占内存的看过来！#

作为一个开发者，你是不是也经常遇到这样的困扰：电脑上装了 MySQL Workbench、Navicat、Redis Desktop Manager、MongoDB Compass…每个工具都要占用几百 MB 甚至上 GB 的内存，开个几个数据库管理工具，电脑就开始卡顿了。

更让人头疼的是，这些工具大多基于 Electron，打包出来动辄几百 MB，启动慢、占用高，用起来体验并不好。作为一个经常需要同时管理多种数据库的开发者，我太懂这种感受了！

直到最近发现了一个宝藏项目——DBX，彻底改变了我的数据库管理体验！这是一个基于 Tauri 2 + Vue 3 开发的开源数据库管理工具，整个安装包只有 15MB，却能支持 40+ 种数据库，简直不敢相信！

这两天这个项目在开发者圈子里特别火，今天我就来和大家好好唠唠这个神器，看看它是如何用 15MB 的体积，实现如此强大的功能的。

✨ 什么是 DBX？#

DBX 是一个开源、轻量级、跨平台的数据库管理 GUI 客户端，由开发者 t8y2 创建并维护。它采用 Tauri 2 框架（Rust 后端）+ Vue 3 前端构建，核心目标是提供一个小巧快速、功能强大的数据库管理工具。

🎯 核心特性#

🚀 超轻量: 整个安装包仅 15MB，启动速度快，内存占用低
📦 多数据库支持: 支持 40+ 种数据库，包括 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、MariaDB、TiDB 等
🔒 本地优先: 数据完全本地存储，无需联网，保护隐私安全
🤖 AI 助手集成: 内置 AI 助手，支持自然语言转 SQL、SQL 解释等功能
🎨 现代化 UI: 基于 Vue 3 构建，界面简洁美观，操作流畅
💰 完全开源: Apache 2.0 许可证，完全免费使用
🔧 高度可定制: 支持自定义主题、快捷键、查询模板等
📊 强大功能: 支持数据浏览、编辑、导出、查询历史、SSH 隧道等

🛠️ 技术栈#

后端#

框架: Tauri 2
语言: Rust
优势: 高性能、低内存占用、安全性强

前端#

框架: Vue 3
语言: TypeScript
构建: Vite
优势: 响应式、组件化、开发效率高

数据库支持#

关系型数据库: MySQL、PostgreSQL、SQLite、SQL Server、MariaDB、TiDB、DuckDB、ClickHouse 等
NoSQL 数据库: Redis、MongoDB 等
持续扩展: 社区驱动，不断增加新数据库支持

📦 安装方式#

Windows#

方式一：下载安装包（推荐）

访问 GitHub Releases 下载最新版本的安装程序，双击运行即可。

方式二：使用 Scoop 安装

Terminal window

1
# 添加 DBX 的 Scoop bucket
2
scoop bucket add dbx https://github.com/t8y2/scoop-bucket
3

4
# 安装 DBX
5
scoop install dbx

macOS#

方式一：下载 DMG 文件

访问 GitHub Releases 下载 DMG 文件，拖拽到应用程序文件夹。

如果遇到”无法打开”的问题，可以：

Terminal window

1
# 方法 1：移除隔离属性
2
xattr -cr /Applications/dbx.app
3

4
# 方法 2：系统设置中允许
5
# 系统设置 → 隐私与安全性 → 仍要打开

方式二：使用 Homebrew 安装

Terminal window

1
brew install --cask dbx

Linux#

方式一：下载 AppImage

访问 GitHub Releases 下载 AppImage 文件，赋予执行权限后运行：

Terminal window

1
chmod +x dbx-*.AppImage
2
./dbx-*.AppImage

方式二：使用 Flatpak 安装

Terminal window

1
flatpak install flathub io.github.t8y2.dbx

Docker 部署#

如果你更喜欢容器化部署：

1
services:
2
  dbx:
3
    image: t8y2/dbx
4
    ports:
5
      - "4224:4224"
6
    volumes:
7
      - ./data:/app/data
8
    restart: unless-stopped

然后访问 http://localhost:4224 即可使用。

🎬 快速上手#

1. 创建数据库连接#

启动 DBX 后，点击左上角的「+」按钮创建新连接：

选择数据库类型（如 MySQL），填写连接信息：

主机: 数据库服务器地址
端口: 数据库端口（MySQL 默认 3306）
用户名: 数据库用户名
密码: 数据库密码
数据库: 要连接的数据库名（可选）

点击「测试连接」确认配置正确，然后保存。

2. 浏览和编辑数据#

连接成功后，在左侧导航栏可以看到数据库结构：

点击任意表，可以：

查看数据: 以表格形式浏览数据
编辑数据: 直接修改单元格内容
筛选排序: 点击列头排序，使用筛选器过滤数据
分页浏览: 支持自定义每页显示条数

3. 执行 SQL 查询#

点击顶部菜单的「SQL」标签，打开查询编辑器：

功能特性：

语法高亮: SQL 关键字自动高亮
智能提示: 输入表名、字段名自动提示
格式化: 一键美化 SQL 格式
执行计划: 查看 SQL 执行计划
结果导出: 支持导出为 CSV、JSON、Markdown 等格式

4. 使用 AI 助手#

DBX 内置了 AI 助手，可以帮助你：

自然语言转 SQL

在 AI 助手中输入：“查询所有用户，按注册时间倒序排列，只显示前 10 条”

AI 会生成：

1
SELECT * FROM users
2
ORDER BY created_at DESC
3
LIMIT 10;

SQL 解释

选中一段复杂的 SQL，点击「解释」按钮，AI 会用通俗语言解释这段 SQL 的作用。

优化建议

AI 还可以分析你的 SQL，提供性能优化建议。

5. Redis 浏览器#

对于 Redis 数据库，DBX 提供了专门的浏览器界面：

支持：

模式匹配搜索: 使用通配符搜索 key
全数据类型支持: String、Hash、List、Set、ZSet
可视化编辑: 直接编辑 value 内容
TTL 管理: 查看和修改过期时间

6. MongoDB 浏览器#

对于 MongoDB 数据库支持：

文档增删改查: 完整的 CRUD 操作
分页浏览: 高效浏览大量文档
JSON 编辑: 原生 JSON 编辑支持
聚合管道: 可视化构建聚合查询

🔥 我的使用感受#

作为一个同时需要管理 MySQL、PostgreSQL、Redis、MongoDB 多种数据库的全栈开发者，DBX 真的彻底改变了我的工作流。

以前我的桌面上要开四五个不同的数据库管理工具，每个都占用几百 MB 内存，电脑风扇呼呼转。现在只需要一个 DBX，15MB 的体积，内存占用只有原来的零头，速度还更快了。

最让我惊喜的是它的 AI 助手功能。有时候忘记某个复杂查询怎么写，直接用自然语言描述需求，AI 就能生成准确的 SQL，还能解释现有查询的逻辑，简直是学习 SQL 的神器！

界面设计也非常舒服，没有传统数据库工具那种复杂的感觉，操作逻辑清晰，新手也能快速上手。深色模式对夜间开发特别友好，长时间使用眼睛也不累。

前几天我用它优化了一个慢查询，AI 助手分析了执行计划后，建议我添加一个复合索引，查询时间从 2 秒降到了 50 毫秒，效果立竿见影！

💡 与其他工具对比#

特性	DBX	Navicat	DataGrip	DBeaver
安装包大小	15MB	300MB+	500MB+	200MB+
内存占用	低	高	高	中
启动速度	快	慢	慢	中
价格	免费	付费	付费	免费 + 付费
AI 助手	✅	❌	✅	❌
开源	✅	❌	❌	✅

从对比可以看出，DBX 在保持轻量的同时，功能并不逊色，而且还有 AI 助手加持，性价比超高。

📝 总结#

今天主要带大家了解了 DBX 这个开源数据库管理工具的完整功能和使用流程，该工具以”Tauri 2 + Vue 3”为核心技术优势，结合多数据库管理需求，通过 Rust 后端与现代化前端框架，形成了一套从轻量级安装包到全功能数据库管理的全链路解决方案。通过这套实践方案，开发者能够高效突破传统数据库工具占用高、启动慢的痛点——借助简洁的连接配置、直观的数据浏览、强大的 SQL 编辑器、智能的 AI 助手，无需安装多个重型工具，就能快速管理 40+ 种数据库（如本次演示的 MySQL、Redis、MongoDB）。无论是关系型数据库查询、NoSQL 数据浏览，还是 SSH 隧道连接、查询历史管理，都能通过统一界面完成，极大提升开发效率。在实际应用中，该工具不仅内存占用低、启动速度快，还完全免费开源，适配性远优于传统商业软件；特别是通过 AI 助手集成，有效解决了复杂 SQL 编写和学习的难题。同时，方案具备良好的扩展性——小伙伴们可以基于此扩展更多数据库类型支持，如 Oracle、Cassandra、Elasticsearch 等，进一步发挥轻量级工具在本地开发、远程运维、团队协作等领域的应用价值。感兴趣的小伙伴可以按照文中提供的步骤进行实践，根据实际数据库类型调整连接配置。今天的分享就到这里结束了，我们下一篇文章见。

🌟 项目资源#

GitHub 地址: https://github.com/t8y2/dbx

官网: https://dbxio.com

Discord 社区: https://discord.gg/W7NyVDRt6a

QQ 群: 1087880322

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 15MB 超小体积，支持 40+ 种数据库，内置 AI 助手，完全开源免费，本地优先保护隐私，是开发者必备的数据库管理神器。

🎉 互动时间#

你是不是已经跃跃欲试了？赶紧去 GitHub 下载体验一下这个轻量的数据库管理工具吧！

你平时都用哪些数据库管理工具？对 DBX 有什么期待？欢迎在评论区和我交流分享！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

离线OCR神器！这个工具让图片文字轻松提取

2026-06-01T00:00:00.000Z

朋友们！需要提取图片文字的看过来！#

看到一张图片里有重要文字，想提取出来却没办法；或者需要识别身份证、名片上的信息，手动输入太麻烦…

今天给大家推荐一个神器——TrWebOCR，一个完全离线的OCR文字识别工具。用了它之后，提取图片文字再也不用求人了！

什么是 TrWebOCR？#

TrWebOCR 是一个完全离线的OCR文字识别工具，支持多语言，识别准确率高，可以私有化部署，保护隐私。

为什么推荐 TrWebOCR？#

1️⃣ 完全离线，隐私安全#

这是我最看重的一点！ 所有文字识别都在本地浏览器中完成，图片数据不会上传到任何服务器。

隐私保护：处理身份证、合同、机密文档等敏感内容时，不用担心数据泄露
无需网络：即使断网也能正常使用，出差旅行必备
数据自主：所有识别结果都保存在本地，完全掌控自己的数据

2️⃣ 多语言支持，覆盖广泛#

TrWebOCR 支持多种语言识别，满足不同场景需求：

中文：完美支持简体中文和繁体中文
英文：支持大小写字母和数字识别
日文/韩文：支持日文汉字和平假名、韩文
混合语言：支持一张图片中多种语言混合识别

3️⃣ 精准识别，效果出色#

基于 PaddleOCR 引擎，识别准确率非常高：

印刷体识别：书籍、报纸、海报等印刷文字，识别率超过 99%
手写体识别：支持部分手写体识别（工整手写效果更佳）
复杂场景：支持倾斜、模糊、低光照等复杂场景的文字识别
多栏识别：智能分析文档布局，支持多栏文字识别

4️⃣ 部署简单，开箱即用#

无论是个人使用还是团队部署，都非常简单：

Docker 一键部署：一条命令即可启动，无需复杂配置
轻量级：镜像体积小，启动速度快，占用资源少
跨平台：支持 Windows、macOS、Linux 等多种系统
API 接口：提供 RESTful API，方便集成到其他系统

5️⃣ 功能丰富，实用便捷#

除了基础识别功能，还有很多实用特性：

批量识别：支持一次上传多张图片批量识别
结果导出：支持复制、下载识别结果，支持多种格式
实时预览：上传图片后实时显示识别结果
移动端适配：支持手机浏览器访问，随时随地识别

6️⃣ 完全开源，免费使用#

TrWebOCR 是开源项目，完全免费：

代码透明：所有代码开源可审计，安全可靠
社区活跃：开发者社区积极维护，持续更新迭代
自由定制：可以根据自己的需求二次开发和定制

如何使用 TrWebOCR？#

步骤1：下载并安装 TrWebOCR#

首先，你需要下载并安装 TrWebOCR。TrWebOCR 支持 Docker 部署，这是最简单的方式。

步骤2：配置 Docker Compose#

创建一个 docker-compose.yml 文件，内容如下：

1
version: '3'
2
services:
3
  trwebocr:
4
    image: mmmz/trwebocr:latest
5
    container_name: trwebocr
6
    restart: unless-stopped
7
    ports:
8
      - "18089:8089"

步骤3：启动 TrWebOCR#

在终端中运行以下命令启动 TrWebOCR：

Terminal window

1
docker-compose up -d

步骤4：访问 TrWebOCR#

打开浏览器，访问 http://localhost:8080，你就可以看到 TrWebOCR 的界面了。

步骤5：开始识别#

点击上传按钮，选择要识别的图片，TrWebOCR 会自动识别图片中的文字。

常见问题#

Q: TrWebOCR 支持哪些语言？ A: TrWebOCR 支持中文、英文、日文、韩文等多种语言。

Q: TrWebOCR 可以离线使用吗？ A: 可以，TrWebOCR 的所有功能都可以离线使用，不需要联网。

Q: TrWebOCR 的识别准确率如何？ A: TrWebOCR 的识别准确率非常高，可以满足大部分场景的需求。

Q: TrWebOCR 支持哪些图片格式？ A: TrWebOCR 支持 JPG、PNG、PDF 等多种格式。

适合谁用？#

学生党：提取教材上的文字，方便做笔记
职场人士：处理扫描件、合同等文档
设计师：提取图片中的文字参考
任何人：需要提取图片文字的场景

注意事项#

图片质量影响识别效果：图片越清晰，识别准确率越高。
首次启动需要加载模型：第一次启动 TrWebOCR 时，需要加载识别模型，可能需要一些时间，请耐心等待。

项目地址#

如果你对 TrWebOCR 感兴趣，可以访问它的 GitHub 仓库：https://github.com/alisen39/TrWebOCR

互动时间#

你有没有遇到过需要提取图片文字的场景？使用 TrWebOCR 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

想要自建图床？这个工具让你打造个人图片分享平台！

2026-05-29T00:00:00.000Z

朋友们！想要自建图床的看过来！#

不想依赖第三方图床；需要稳定的图片外链；想打造个人图片分享平台…

今天给大家推荐一个神器——Chevereto，一个开源的图床服务工具。自从用了它，我的图片分享终于自由了！

什么是 Chevereto？#

Chevereto 是一个开源的图床服务工具，它可以让你搭建自己的图片分享平台，支持图片上传和外链分享。

为什么推荐 Chevereto？#

1️⃣ 图床服务#

专业的图床功能：

支持批量上传
支持图片压缩
支持多种格式

2️⃣ 外链支持#

方便分享图片：

支持直接外链
支持多种链接格式
支持一键复制

3️⃣ 多端支持#

随时随地访问：

支持 Web 端访问
支持移动端访问
支持 API 访问

4️⃣ 用户管理#

支持多用户：

支持用户注册
支持权限管理
支持访问统计

5️⃣ 完全开源#

Chevereto 是开源项目，完全免费使用：

代码透明可审计
支持自定义修改
社区活跃持续更新

如何使用 Chevereto？#

步骤1：部署 Chevereto#

1
services:
2
  database:
3
    image: mariadb:jammy
4
    networks:
5
      - chevereto
6
    volumes:
7
      - /你的本地路径/database:/var/lib/mysql  # 数据库也放本地
8
    restart: always
9
    healthcheck:
10
      test: ["CMD", "healthcheck.sh", "--su-mysql", "--connect"]
11
      interval: 10s
12
      timeout: 5s
13
      retries: 3
14
    environment:
15
      MYSQL_ROOT_PASSWORD: password
16
      MYSQL_DATABASE: chevereto
17
      MYSQL_USER: chevereto
18
      MYSQL_PASSWORD: user_database_password
19

20
  php:
21
    image: chevereto/chevereto:latest
22
    networks:
23
      - chevereto
24
    volumes:
25
      - /你的本地路径/images:/var/www/html/images  # 图片存在这里
26
    restart: always
27
    depends_on:
28
      database:
29
        condition: service_healthy
30
    ports:
31
      - "8080:80"
32
    environment:
33
      CHEVERETO_DB_HOST: database
34
      CHEVERETO_DB_USER: chevereto
35
      CHEVERETO_DB_PASS: user_database_password
36
      CHEVERETO_DB_PORT: 3306
37
      CHEVERETO_DB_NAME: chevereto
38
      CHEVERETO_HOSTNAME: hostname.com
39
      CHEVERETO_HOSTNAME_PATH: /
40
      CHEVERETO_HTTPS: 0
41
      CHEVERETO_MAX_POST_SIZE: 2G
42
      CHEVERETO_MAX_UPLOAD_SIZE: 2G
43

44
# 下面这部分 volumes 全部删掉！！
45
# volumes:
46
#   database:
47
#   storage:
48

49
networks:
50
  chevereto:

展开收起

步骤2：启动服务#

Terminal window

1
docker-compose up -d

步骤3：配置图床#

访问 http://localhost:8080，完成初始化配置。

步骤4：上传图片#

开始上传和分享你的图片！

常见问题#

Q: Chevereto 需要什么配置？ A: Chevereto 对硬件要求不高，建议至少 2GB 内存。

Q: 支持哪些图片格式？ A: 支持 JPG、PNG、GIF 等常见格式。

Q: 需要联网吗？ A: 自建部署的话可以离线使用，但分享功能需要联网。

Q: 支持远程访问吗？ A: 支持，需要配置端口映射或使用反向代理。

我的使用体验#

图床服务很稳定
外链功能很实用
管理功能很完善
开源免费，性价比很高

适合谁用？#

博主：需要图片外链
开发者：需要共享截图
设计师：分享设计作品
任何人：想要自建图床

注意事项#

存储容量：图片文件需要存储空间
带宽考虑：外链会消耗带宽
内容管理：注意管理上传内容

项目地址#

如果你对 Chevereto 感兴趣，可以访问它的 GitHub 仓库：https://github.com/Chevereto/Chevereto

互动时间#

你们会选择GitHub做图床还是用Chevereto呢？

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

保姆级教程！用PicList+GitHub搭建免费图床，超详细配置指南！

2026-05-28T00:00:00.000Z

朋友们！写博客的小伙伴看过来！#

写博客时图片托管是个大问题；免费图床不稳定；付费图床太贵…

今天给大家带来一个完美解决方案——PicList + GitHub 免费图床！这是我一直在用的图床方案，稳定又免费，配置也很简单，跟着我一步步来，包你学会！

什么是 PicList？#

PicList 是一款强大的云存储图床管理工具，支持多种云存储平台，包括 GitHub、Gitee、阿里云OSS、腾讯云COS等。它提供了简洁的界面和强大的功能，让图片上传和管理变得非常方便。

为什么选择 PicList + GitHub？#

1️⃣ 完全免费#

GitHub 提供免费的仓库存储，对于个人博客使用完全足够。

2️⃣ 稳定可靠#

GitHub 作为全球最大的代码托管平台，稳定性毋庸置疑。

3️⃣ 访问速度快#

配合 jsDelivr CDN，图片加载速度非常快。

4️⃣ 永久存储#

只要 GitHub 不倒闭，你的图片就永远存在。

5️⃣ 支持自定义域名#

可以配置自定义域名，让图片链接更美观。

准备工作#

在开始配置之前，我们需要准备以下东西：

一个 GitHub 账号（没有的话去注册一个）
下载 PicList（官网：https://piclist.cn/app#下载安装）

详细配置教程#

步骤1：创建 GitHub 仓库#

首先，我们需要在 GitHub 上创建一个专门用于存放图片的仓库。

打开 GitHub 官网：https://github.com/,访问不了的话，可以参考[SteamTools 让你一键加速GitHub和Steam，告别网络问题](https://mp.weixin.qq.com/s/qKNZhgiM63HZVlU9ZRWYNg?token=1876705190&lang=zh_CN) 这篇文章来访问github官网
登录你的账号
点击右上角的 + 号，选择 New repository
填写仓库信息：
- Repository name：输入仓库名称，比如 images 或 blog-images
- Description：可以填写描述，比如 博客图片仓库
- Visibility：选择 Public（公开仓库才能被访问）
- 勾选 Add a README file（可选）
点击 Create repository 创建仓库

步骤2：生成 GitHub Access Token#

接下来，我们需要生成一个 Access Token，用于 PicList 访问你的 GitHub 仓库。

点击右上角你的头像，选择 Settings
在左侧菜单中找到 Developer settings
点击 Personal access tokens
点击 Tokens (classic)（注意：一定要选 classic 类型）
点击 Generate new token
填写信息：
- Note：输入描述，比如 PicList Token
- Expiration：选择 token 的有效期，建议选 No expiration（永不过期）
- Select scopes：勾选以下权限：
  - repo（完全控制仓库）
  - workflow（可选，如果需要）
点击 Generate token
重要：复制生成的 token，这个 token 只会显示一次，一定要保存好！

步骤3：下载并安装 PicList#

访问 PicList 官网：https://piclist.cn/
根据你的系统下载对应的版本（Windows/macOS/Linux）
安装并打开 PicList

步骤4：配置 PicList 图床#

打开 PicList 后，我们来配置 GitHub 图床。

点击左侧菜单栏的 图床设置
在图床列表中，找到 GitHub，点击进入配置页面
填写配置信息：

仓库配置#

仓库所有者：你的 GitHub 用户名（比如 username）
仓库名称：你刚创建的仓库名（比如 images）
分支：默认 main 或 master（看你仓库的默认分支）
Token：粘贴你刚才生成的 Access Token
路径：图片存放的目录，比如 images/（注意后面要有斜杠）
自定义域名：
- 默认留空，使用 GitHub 原生域名
- 如果想使用 jsDelivr CDN，填 https://cdn.jsdelivr.net/gh/用户名/仓库名
- 比如：https://gcore.jsdelivr.net/gh/wangbin-blog/images@main

其他配置#

存储区域：默认即可
超时时间：默认 30 秒即可
文件命名：选择你喜欢的命名方式，推荐 时间戳 或 原文件名

点击 测试上传，如果显示上传成功，说明配置正确！

步骤5：设置默认图床#

配置完成后，回到图床列表
找到你刚配置的 GitHub 图床
点击右侧的 设为默认
这样每次上传图片都会默认使用这个图床

使用 PicList 上传图片#

配置完成后，使用就非常简单了！

方法1：拖拽上传#

打开 PicList 的主界面
直接将图片拖拽到界面中
上传完成后，会自动复制图片链接到剪贴板

方法2：快捷键上传#

点击右下角的 PicList 图标
选择 上传图片
选择要上传的图片即可

方法3：右键菜单上传#

在文件管理器中右键点击图片
选择 PicList 上传图片

方法4：剪贴板上传#

使用截图工具截取图片（比如 Win+Shift+S）
按下 Ctrl+V（或 Cmd+V）直接粘贴到 PicList
图片会自动上传并复制链接

自定义链接格式#

如果你想自定义图片链接的格式，可以这样设置：

进入图床设置页面
找到 链接格式 设置
可以自定义输出的链接格式，支持多种格式：
- Markdown 格式：![图片描述](图片链接)
- HTML 格式：
- 纯链接格式：图片链接

使用 jsDelivr CDN 加速#

为了让图片加载更快，强烈推荐使用 jsDelivr CDN：

在 GitHub 图床配置中，将 自定义域名 设置为：
```
1
https://cdn.jsdelivr.net/gh/用户名/仓库名
```
比如：https://cdn.jsdelivr.net/gh/wangbin/blog-images
jsDelivr 的优点：
- 全球 CDN 加速
- 自动缓存
- 支持 HTTPS
- 完全免费

常见问题#

Q: 为什么上传失败？ A: 请检查以下几点：

Token 是否正确
Token 是否有 repo 权限
仓库是否为公开（Public）
网络是否正常

Q: 图片链接无法访问？ A: 请检查：

仓库是否为公开
文件路径是否正确
自定义域名是否配置正确

Q: 可以使用私有仓库吗？ A: 不建议使用私有仓库，因为私有仓库的图片无法被外部访问。

Q: 存储空间有限制吗？ A: GitHub 免费版每个仓库有 1GB 空间限制，对于博客图片完全足够。

Q: 如何批量上传图片？ A: PicList 支持批量选择多张图片上传，直接拖拽多张图片即可。

Q: 如何管理已上传的图片？ A: 在 PicList 中点击左侧的 相册，可以查看和管理所有已上传的图片。

我的使用体验#

我使用 PicList + GitHub 图床已经好多年了，非常稳定：

上传速度快：拖拽上传非常方便
链接格式多样：支持多种格式，复制即用
管理方便：相册功能可以查看和管理所有图片
完全免费：不用花一分钱

注意事项#

仓库设为公开：必须将仓库设置为 Public，否则图片无法被访问
保护好 Token：Token 相当于你的密码，不要泄露给别人
定期备份：虽然 GitHub 很稳定，但建议定期备份重要图片
图片命名：建议使用有意义的文件名，方便管理

总结#

使用 PicList + GitHub 搭建免费图床非常简单，总结一下步骤：

创建 GitHub 公开仓库
生成 Access Token
配置 PicList
开始上传图片！

这是一个非常完美的图床方案，推荐给所有需要图片托管的小伙伴！

互动时间#

你们平时都用什么图床？有没有遇到过图片链接失效的问题？欢迎在评论区分享你的经验！

如果你在配置过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

Windows卸载工具！这个工具让卸载软件更彻底！

2026-05-27T00:00:00.000Z

朋友们！Windows用户看过来！#

卸载软件不彻底；残留文件难清理；想要批量卸载…

今天给大家推荐一个超级好用的工具——Bulk Crap Uninstaller，一个开源的Windows批量卸载工具。自从用了它，我的系统变得更干净了！

什么是 Bulk Crap Uninstaller？#

Bulk Crap Uninstaller（简称BCUninstaller）是一个开源的Windows软件卸载工具，它可以批量卸载多个程序，清理残留文件和注册表项，是Windows系统清理的必备工具。

为什么推荐 Bulk Crap Uninstaller？#

1️⃣ 批量卸载#

批量处理：

支持批量选择多个程序
支持一键卸载多个软件
支持批量删除残留文件

2️⃣ 彻底清理#

彻底卸载：

支持清理残留文件
支持清理注册表项
支持清理空文件夹

3️⃣ 智能检测#

智能识别：

支持检测捆绑软件
支持检测广告软件
支持检测恶意软件

4️⃣ 用户友好#

友好界面：

支持图形界面
支持搜索过滤
支持排序功能

5️⃣ 完全开源#

BCUninstaller 是开源项目，完全免费使用：

代码透明可审计
支持自定义修改
社区活跃持续更新

如何使用 Bulk Crap Uninstaller？#

步骤1：下载安装#

BCUninstaller 是便携软件，无需安装，下载即可使用：

访问 GitHub 发布页：https://github.com/Klocman/Bulk-Crap-Uninstaller/releases
下载最新版本的 BCUninstaller_x64.zip（64位系统）或 BCUninstaller_x86.zip（32位系统）
解压到任意目录，双击 BCUninstaller.exe 即可运行

步骤2：首次启动与扫描#

打开软件后，BCUninstaller 会自动扫描系统，列出所有已安装的程序。扫描完成后，你会看到：

程序列表：显示所有已安装软件的名称、版本、大小、安装日期
分类标签：顶部有「All」「User」「System」等标签，可快速筛选
搜索框：支持按程序名称快速搜索

步骤3：选择要卸载的程序#

选择程序的几种方式：

手动勾选：点击程序左侧的复选框
批量选择：按住 Ctrl 或 Shift 键多选
智能筛选：
- 点击「Junk」标签，筛选捆绑软件和广告软件
- 使用搜索框搜索特定程序

步骤4：开始批量卸载#

确认选中的程序无误后，点击顶部工具栏的「卸载」按钮，也可以选择「静默卸载」模式，这样会自动卸载所有选中的程序，不会弹出确认窗口提示。
在弹出的确认窗口中，再次确认卸载操作，点击「继续」。
BCUninstaller 会依次运行每个程序的卸载程序
卸载完成后，BCUninstaller 会自动刷新程序列表，显示已卸载的程序。

步骤5：清理残留文件#

卸载完成后，BCUninstaller 会自动检测并清理残留：

勾选「Delete leftover files and registry entries」选项
点击「Cleanup」按钮
软件会扫描并删除残留的文件夹、文件和注册表项

步骤6：高级功能#

强力卸载模式：

对于无法正常卸载的顽固软件，右键点击程序，选择「Force Uninstall」
强力卸载会强制删除程序目录和注册表项

导出列表：

点击「File」→「Export to CSV」，可导出已安装程序列表

刷新扫描：

点击「Refresh」按钮，重新扫描系统

适合谁用？#

Windows用户：清理系统
电脑小白：简单操作
系统管理员：批量管理
任何人：需要卸载软件

注意事项#

备份数据：卸载前注意备份重要数据
谨慎操作：注意选择要卸载的程序
重启系统：卸载后建议重启系统

项目地址#

如果你对 BCUninstaller 感兴趣，可以访问它的 GitHub：https://github.com/Klocman/Bulk-Crap-Uninstaller

互动时间#

你们平时怎么卸载Windows软件？有没有用过 BCUninstaller？使用后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

从Hexo到Astro Firefly：我的博客迁移之旅
上班摸鱼神器！这个工具让老板以为你在疯狂加班
Redis管理神器！这个工具让你的数据操作更高效
又一个 Rust 神级编辑器！Fresh 让我放弃了 VS Code
不想修改hosts？这个神器更简单！SteamTools 让你一键加速GitHub和Steam，告别网络问题
替代Notion的最佳选择！这个开源工具太惊艳了
发现宝藏音乐软件！LX Music 让你告别多 app 切换，一个软件听遍所有平台（注：文章部分信息来源于项目官方文档和个人使用体验）

Docker打包神器！这个Electron工具让镜像管理更高效！

2026-05-27T00:00:00.000Z

朋友们！Docker用户看过来！#

镜像构建太复杂；多个环境配置难管理；想要一键打包导出…

今天给大家推荐一个神器——docker-packager，一个开源的Electron桌面工具，专门用于管理多个Docker镜像打包配置，让镜像构建和导出变得轻松简单！

什么是 docker-packager？#

docker-packager 是一个基于 Electron + React + TypeScript 开发的桌面应用，用于管理多个 Docker 镜像打包配置，并将镜像构建后导出为 .tar 文件。它支持多项目、多环境管理，支持 x64/arm64 架构打包，是 Docker 开发者的必备工具。

为什么推荐 docker-packager？#

1️⃣ 多项目管理#

管理多个项目：

支持添加多个项目配置
每个项目可配置多个环境（开发/测试/生产）
环境独立配置镜像名、Tag、目标架构

2️⃣ 一键打包#

简单的打包流程：

支持单环境打包
支持批量顺序打包
支持批量并行打包
实时日志标签页展示

3️⃣ 多平台支持#

跨平台构建：

支持 x64 / arm64 架构打包
支持 Windows/macOS/Linux
底层执行 docker build 和 docker save

4️⃣ 智能功能#

实用功能：

预览 Docker 构建与导出命令
Docker Desktop 状态检测与启动
配置自动备份与历史还原
任务停止、输出文件复制与打开

5️⃣ 完全开源#

docker-packager 是开源项目，完全免费使用：

代码透明可审计
支持自定义修改
社区活跃持续更新

如何使用 docker-packager？#

步骤1：环境准备#

首先确保安装了以下依赖：

Terminal window

1
# 1. 安装 Node.js 20+
2
# 访问 https://nodejs.org/ 下载安装
3

4
# 2. 安装 Docker Desktop
5
# 访问 https://www.docker.com/ 下载安装
6

7
# 验证 Docker
8
docker version

步骤2：获取源码#

Terminal window

1
git clone https://github.com/chongchong59699/docker-packager.git
2
cd docker-packager

步骤3：开发运行#

进入 Electron 应用目录并启动开发环境：

Terminal window

1
cd electron
2
npm install
3
npm run dev

npm run dev 会启动 Vite 与 Electron 开发环境，打开应用界面。

步骤4：打包发布#

Windows Portable 版本#

Terminal window

1
cd electron
2
npm run pack:win

输出目录：electron/release-build//

Windows 安装包#

Terminal window

1
cd electron
2
npm run pack:win:installer

macOS / Linux#

Terminal window

1
cd electron
2
npm run pack:mac
3
npm run pack:linux

步骤5：使用应用#

打开应用后，你可以：

管理项目：添加多个项目配置
配置环境：为每个项目添加不同环境（开发/测试/生产）
设置参数：配置镜像名、Tag、目标架构（x64/arm64）、输出文件
预览命令：查看 Docker 构建与导出命令预览
开始打包：
- 单环境打包
- 批量顺序打包
- 批量并行打包

步骤6：核心命令说明#

应用执行的核心命令等价于：

架构映射：

x64 / x86_64 → linux/amd64
arm64 / arm → linux/arm64

步骤7：配置管理#

配置文件保存在 Electron userData 目录下的 config/projects.json：

1
{
2
  "projects": [
3
    {
4
      "id": "demo-service",
5
      "name": "Demo Service",
6
      "path": "E:\\project\\demo-service",
7
      "environments": [
8
        {
9
          "id": "prod",
10
          "name": "正式环境",
11
          "image": "demo-service",
12
          "tag": "1.0.0",
13
          "architecture": "x86_64",
14
          "output": "demo-service-1.0.0-x86_64.tar"
15
        }
16
      ]
17
    }
18
  ]
19
}

展开收起

常见问题#

Q: 找不到 docker 命令怎么办？ A: 请安装 Docker Desktop，并确认 docker 已加入 PATH，运行 docker version 验证。

Q: Docker 未启动怎么办？ A: 可以在应用顶部点击”启动 Docker”，也可以手动启动 Docker Desktop，等待 daemon 就绪后再打包。

Q: Electron 打包失败怎么办？ A: 先执行 npm install && npm run build 确认依赖和构建正常。Windows 签名相关问题可关闭强制签名。

Q: 打包后图标未生效怎么办？ A: 应用图标维护在 electron/resources/icon.ico，Windows 打包时由 electron-builder.yml 的 win.icon 配置。

我的使用体验#

界面友好：Electron 应用界面美观，操作直观
管理方便：多项目多环境管理一目了然
打包高效：批量并行打包节省大量时间
功能实用：配置自动备份、命令预览等功能很贴心

适合谁用？#

Docker开发者：需要频繁构建镜像
运维人员：管理多个项目的镜像打包
团队：统一管理项目的Docker配置
个人开发者：简化镜像构建流程

注意事项#

环境要求：需要 Node.js 20+ 和 Docker Desktop
配置备份：配置文件会自动备份，定期检查备份目录
资源占用：并行打包时注意 CPU 和内存占用

项目地址#

如果你对 docker-packager 感兴趣，可以访问它的 GitHub：https://github.com/chongchong59699/docker-packager

互动时间#

你们平时怎么管理Docker镜像？有没有用过类似的桌面工具？使用后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

环境音效神器！这个工具让我的工作更专注

2026-05-25T00:00:00.000Z

前言#

你有没有遇到过这些场景？

工作时环境太吵，无法集中注意力；想要营造氛围，却找不到合适的音效；市面上的音效软件太贵…

今天给大家推荐一个神器——Moodist，一个免费开源可混搭的环境音效工具。用了它之后，我的工作效率提升了很多！

为什么选择 Moodist？#

1️⃣ 完全免费#

没有任何隐藏费用，所有功能全部免费使用。

2️⃣ 音效丰富#

提供多种环境音效，满足不同场景需求。

3️⃣ 完全开源#

代码完全开源，你可以自己定制和扩展。

4️⃣ 功能强大#

支持音效混搭、定时关闭、音量调节等功能。

5️⃣ 跨平台#

支持多种操作系统。

主要功能介绍#

🎵 音效库#

提供多种环境音效
包括白噪音、森林、雨声、咖啡馆等
可以自定义音效

🎚️ 音效混搭#

可以同时播放多种音效
支持音量独立调节
可以保存音效组合

⏱️ 定时功能#

支持定时关闭
可以设置倒计时
支持睡眠模式

📱 多端支持#

支持 Web 端访问
支持桌面端应用
可以作为浏览器插件

🔄 同步功能#

支持音效组合同步
可以保存和分享配置
支持云端备份

怎么部署？#

部署非常简单，用 Docker 一键搞定：

使用 Docker 命令：

Terminal window

1
docker run -d  --name moodist  -p 8080:8080  ghcr.io/remvze/moodist:latest

然后访问 http://localhost:8080 就能使用了。

使用 Docker Compose（推荐）：

1
services:
2
  moodist:
3
    image: ghcr.io/remvze/moodist:latest
4
    container_name: moodist
5
    ports:
6
      - "8080:8080"
7
    restart: unless-stopped  # 可选，推荐加上，让容器自动重启

启动服务：

Terminal window

1
docker compose up -d

然后访问 http://localhost:8080 就能使用了。

适合谁用？#

学生党：学习时营造专注氛围
职场人士：工作时提高效率
创作者：激发灵感，提升创造力
任何人：想要一个更好的工作或学习环境

总结#

Moodist 是一个非常优秀的开源环境音效工具，功能强大、音效丰富、完全免费。如果你想要提高专注力，一定要试试它！

互动时间#

你平时工作或学习时喜欢什么环境音效？欢迎在评论区分享！

项目地址：https://github.com/remvze/moodist

官方网站：https://moodist.mvze.net/

推荐阅读：

文件分发神器！这个工具让文件分享更安全

2026-05-25T00:00:00.000Z

朋友们！需要安全分享文件的看过来！#

有没有遇到过这些问题：

文件分享不安全？
无法控制文件访问权限？
需要追踪文件下载情况？

今天给大家推荐一个神器——ProjectSend，一个安全的文件分发工具，让文件分享更可控！

什么是 ProjectSend？#

ProjectSend 是一个开源的文件分发工具，可以帮助你安全地分享文件给特定用户，支持权限控制、下载追踪等功能。

为什么推荐 ProjectSend？#

1️⃣ 权限控制#

可以精确控制谁可以访问文件。

2️⃣ 下载追踪#

追踪文件的下载情况，记录下载日志。

3️⃣ 文件加密#

支持文件加密，保护文件安全。

4️⃣ 多用户支持#

支持多用户使用，适合团队协作。

5️⃣ 完全开源#

代码开源，可以自己部署使用。

如何使用 ProjectSend？#

步骤1：安装 ProjectSend#

使用 Docker 部署（推荐）：

1
version: "3"
2
services:
3
  projectsend:
4
    image: lscr.io/linuxserver/projectsend:latest
5
    container_name: projectsend
6
    environment:
7
      - PUID=1000
8
      - PGID=1000
9
      - TZ=Etc/UTC
10
    volumes:
11
      - ./config:/config
12
      - ./data:/data
13
    ports:
14
      - 18880:80
15
    restart: unless-stopped

展开收起

也可以上github，下载release版本。使用源码部署，这里就以docker-compose为例。

步骤2：启动服务#

Terminal window

1
docker-compose up -d

步骤3：访问 ProjectSend#

打开浏览器，访问 http://localhost:18880。

步骤4：配置系统#

按照向导配置数据库和管理员账号。

步骤5：上传文件#

上传文件，设置访问权限和用户。

常见问题#

Q: ProjectSend 支持哪些权限控制？ A: 支持设置用户访问权限、下载次数限制、过期时间等。

Q: ProjectSend 可以追踪下载记录吗？ A: 支持，记录每个文件的下载日志。

Q: ProjectSend 需要付费吗？ A: 完全免费，开源软件。

Q: ProjectSend 支持文件加密吗？ A: 支持，上传的文件可以加密存储。

我的使用体验#

我用 ProjectSend 分享文件，体验非常好：

权限控制精细，安全可靠
下载追踪，方便管理
文件加密，保护隐私
多用户支持，适合团队
开源免费，没有任何限制

适合谁用？#

企业用户：安全分享企业文件
团队用户：协作分享项目文件
教育机构：分享学习资料
普通用户：安全分享重要文件

注意事项#

安全配置：设置强密码，启用 HTTPS
权限管理：合理设置用户权限
定期备份：定期备份数据，防止丢失

项目地址#

GitHub：https://github.com/projectsend/projectsend
官网地址：https://www.projectsend.org/

互动时间#

你平时如何分享敏感文件？有没有遇到过安全问题？欢迎在评论区分享！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

Redis管理神器！这个工具让你的数据操作更高效

2026-05-22T00:00:00.000Z

🔴 朋友们！Redis管理工具选对了吗？看过来！#

作为一个开发者，每天都要和 Redis 打交道：

查看数据太麻烦，命令行记不住？
连接远程服务器太复杂，还要配置SSH？
数据量大了卡顿，列表加载半天？

今天给大家推荐一个神器——Tiny RDM，一个现代化的轻量级 Redis 桌面管理器！

🎯 什么是 Tiny RDM？#

Tiny RDM 是一个基于 Wails 框架开发的现代轻量级跨平台 Redis 桌面管理器，支持 Mac、Windows、Linux，还可以通过 Docker 部署 Web 版本。

✨ 为什么推荐 Tiny RDM？#

1️⃣ 轻量级设计#

基于 Webview2 技术，不内嵌浏览器，启动快、占用内存少。

2️⃣ 多连接方式支持#

✅ SSH Tunnel（SSH 隧道）
✅ SSL/TLS 加密连接
✅ Sentinel 模式
✅ Cluster 集群模式
✅ HTTP 代理 / SOCKS5 代理

3️⃣ 可视化数据操作#

支持多种数据类型的 CRUD 操作：

📝 String（字符串）
📋 List（列表）
🗂️ Hash（哈希）
📦 Set（集合）
📊 Sorted Set（有序集合）
🔄 Stream（流）

4️⃣ 强大的功能特性#

🔍 SCAN 分段加载：轻松处理百万级 key
📋 命令历史日志：记录所有操作
⚡ 命令行模式：支持直接输入命令
🐢 慢日志查看：优化性能问题
🔄 发布/订阅：实时消息监听
📤 数据导入导出：方便数据迁移

5️⃣ 跨平台支持#

支持 Windows、macOS、Linux，还可以通过 Docker 部署 Web 版本！

🚀 安装方式#

方式1：下载桌面客户端#

访问 GitHub Releases 下载对应平台的安装包：

Windows：.exe 安装包
macOS：.dmg 镜像或 .zip 压缩包
Linux：.deb、.rpm 或 AppImage

macOS 注意事项：如果安装后无法打开，执行以下命令：

Terminal window

1
sudo xattr -d com.apple.quarantine /Applications/Tiny\ RDM.app

或者上它的官网下载：

方式2：Docker 部署 Web 版本（适合服务端部署）#

使用 Docker Compose（推荐）：

创建 docker-compose.yml 文件：

1
services:
2
  tinyrdm:
3
    image: ghcr.io/tiny-craft/tiny-rdm:latest
4
    container_name: tinyrdm
5
    restart: unless-stopped
6
    ports:
7
      - "8086:8086"
8
    environment:
9
      - ADMIN_USERNAME=admin
10
      - ADMIN_PASSWORD=tinyrdm
11
    volumes:
12
      - ./data:/app/tinyrdm

启动服务：

Terminal window

1
docker compose up -d

访问 http://localhost:8086，使用配置的账号密码登录。

使用 Docker 命令：

Terminal window

1
docker run -d --name tinyrdm \
2
  -p 8086:8086 \
3
  -e ADMIN_USERNAME=admin \
4
  -e ADMIN_PASSWORD=tinyrdm \
5
  -v ./data:/app/tinyrdm \
6
  ghcr.io/tiny-craft/tiny-rdm:latest

🎮 使用教程#

步骤1：创建连接#

打开 Tiny RDM，点击左上角 “New Connection”：

步骤2：配置连接信息#

根据你的 Redis 服务器类型选择连接方式：

普通连接：

Host: 服务器地址
Port: 端口（默认 6379）
Password: 密码（如果有）

SSH 隧道连接：

SSH Host: SSH 服务器地址
SSH Port: SSH 端口（默认 22）
SSH Username: 用户名
SSH Password/Key: 密码或密钥

步骤3：管理数据#

连接成功后，你可以：

浏览 Key：左侧显示所有 key，支持搜索和过滤
查看/编辑值：点击 key 查看详细内容，支持多种显示格式
执行命令：使用底部命令行输入 Redis 命令
批量操作：支持批量删除、导出等操作

步骤4：高级功能#

命令监控：实时查看执行的命令
慢日志：查看慢查询命令
发布/订阅：订阅频道接收消息
数据导入导出：JSON 格式导入导出

📊 功能对比#

功能	Tiny RDM	Redis Desktop Manager
轻量级	✅ 非常轻量	❌ 较重
跨平台	✅ 全平台 + Web	✅ 桌面端
SSH 隧道	✅ 支持	❌ 不支持
集群模式	✅ 支持	✅ 支持
命令行	✅ 内置	✅ 支持
慢日志	✅ 支持	✅ 支持
开源免费	✅ 开源 GPL	❌ 收费

💡 实用技巧#

技巧1：快速搜索 Key#

使用 * 通配符搜索：

1
user:*
2
order:*:status

技巧2：批量操作#

选中多个 key，右键选择批量删除或导出。

技巧3：自定义解码器#

支持自定义数据编解码器，处理特殊格式的数据。

技巧4：连接配置导入导出#

可以导出连接配置，方便在多台设备间同步。

🛠️ 我的使用体验#

用了 Tiny RDM 之后：

✅ 效率提升：可视化操作比命令行快太多
✅ 稳定性好：处理百万级 key 不卡顿
✅ 功能齐全：SSH 隧道、集群模式都支持
✅ 跨平台：在家用 macOS，公司用 Windows，无缝切换
✅ 开源免费：不用再找破解版了

📦 项目地址#

GitHub：https://github.com/tiny-craft/tiny-rdm
官网：https://tinyrdm.com/
文档：https://tinyrdm.com/guide/

💬 互动时间#

你平时用什么工具管理 Redis？有没有遇到过什么痛点？

欢迎在评论区分享你的使用体验！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

从Hexo到Astro Firefly：我的博客迁移之旅

2026-05-21T00:00:00.000Z

朋友们！还在纠结博客框架选择吗？看过来！#

作为一个写了几年博客的技术博主，我最近完成了从 Hexo 到 Astro Firefly 的迁移。今天就来和大家分享一下这次迁移的全过程，包括两个框架的对比、迁移步骤以及部署经验。

为什么要从 Hexo 迁移到 Astro？#

📊 框架对比#

特性	Hexo	Astro Firefly
技术栈	Node.js + EJS/Pug	Astro + Svelte + Tailwind CSS
构建速度	中等	极快（增量构建）
加载速度	一般	超快（零JS默认）
SEO优化	依赖插件	内置优化
开发体验	静态渲染	混合渲染（SSR/SSG）
生态系统	插件丰富但陈旧	现代化且活跃
TypeScript	支持有限	原生支持
热更新	较慢	毫秒级响应

✨ Astro 的核心优势#

更快的构建速度：Astro 的增量构建让开发体验大幅提升
更好的性能：默认零 JS，首屏加载极快
现代化技术栈：支持 React、Vue、Svelte 等多种框架
内置优化：自动代码分割、图片优化、SEO 友好

🚀 迁移过程详解#

步骤1：环境准备#

首先确保你的环境满足要求：

Terminal window

1
# 检查 Node.js 版本（需 ≥ 22）
2
node -v
3

4
# 安装 pnpm（推荐）
5
npm install -g pnpm
6
pnpm -v

步骤2：Fork Firefly 仓库#

在 GitHub 上 Fork Firefly 仓库到你的账户。

Terminal window

1
# Fork Firefly 仓库地址
2
https://github.com/CuteLeaf/Firefly

步骤3：初始化 Firefly 项目#

Terminal window

1
# 克隆仓库（建议先 Fork 到自己的仓库）
2
git clone https://github.com/你的用户名/Firefly.git
3
cd Firefly
4

5
# 安装依赖
6
pnpm install

步骤4：配置博客基础信息#

编辑 src/config/siteConfig.ts：

1
// 站点基础配置
2
export const SITE_CONFIG = {
3
  name: "你的博客名称",
4
  title: "你的博客标题",
5
  description: "你的博客描述",
6
  lang: "zh_CN",
7
  url: "https://你的域名.com",
8
  // ... 其他配置
9
};

步骤5：迁移文章内容#

Hexo 的文章通常在 source/_posts/ 目录，需要迁移到 Astro 的 src/content/posts/ 目录。

Frontmatter 转换示例：

Hexo 格式：

1
---
2
title: 文章标题
3
date: 2024-01-01 12:00:00
4
tags: [标签1, 标签2]
5
category: 分类
6
---

Firefly 格式：

1
---
2
title: 文章标题
3
published: 2024-01-01
4
description: 文章描述
5
image: ./cover.jpg # 或使用 "api" 启用随机封面
6
tags: [标签1, 标签2]
7
category: 分类
8
draft: false
9
pinned: false
10
comment: true
11
---

步骤6：处理图片和静态资源#

将 Hexo 的 source/images/ 迁移到 Astro 的 public/ 目录。

Terminal window

1
# 复制图片资源
2
cp -r ../hexo-blog/source/images/* public/images/

步骤7：配置导航栏#

编辑 src/config/navBarConfig.ts 配置导航菜单组件.

步骤7：配置侧边栏#

和 src/config/sidebarConfig.ts 配置侧边栏组件。

更多个性化配置，请参考 Firefly 主题文档。

步骤7：本地测试#

Terminal window

1
# 启动开发服务器
2
pnpm dev
3

4
# 构建生产版本
5
pnpm build
6

7
# 预览构建结果
8
pnpm preview

🛠️ 部署实战：Vercel + Cloudflare#

登录 Vercel，点击 “New Project”

2. 导入仓库，选择你的 Firefly 仓库 3. 配置项目(默认已配置好，确认即可)：

Framework Preset: Astro
Root Directory: ./
Build Command: pnpm run build
Output Directory: dist

点击 Deploy，等待部署完成
配置域名（可选）：Vercel 域名在国内访问速度较慢，建议配置自定义域名。这里以 Cloudflare 为例，配置域名后即可访问。
- 购买域名（如果还没有）
- 打开刚部署好的 Vercel 项目，点击 “Domains” 选项卡，添加自定义域名。
- 在 Cloudflare 控制台添加自定义域名
- 配置 DNS 记录，将域名指向 Vercel 提供的 IP 地址
- 等待 DNS 记录生效（通常需要 10-30 分分钟）
必应IndexNow（可选）：
- 去必应 IndexNow 点击 “Get Started” 按钮
- 在打开的页面中，下滑到页面底部，有一个Generate API Key 区域，点击 “Generate” 按钮，即可获取新的API Key，复制该 Key 到剪贴板，
- 然后到blog根目录/public/文件夹下创建一个apikey.txt文件，将复制的API Key 放入文件中,注意txt文件名也为key的内容。
- 安装必应 IndexNow 插件,在根目录执行pnpm install astro-indexnow
- 配置插件,在blog/astro.config.mjs中添加以下内容：
```
1
//  引入 IndexNow 插件
2
import indexnow from 'astro-indexnow';
3

4

5
// 新增 IndexNow
6
indexnow({
7
key: '7axxxxxxxxxxxxxxxxxxxb43c1', // 你的Key
8
// 可选：指定引擎（默认必应+Yandex）
9
keyLocation: '/7axxxxxxxxxxxxxxxxxxxb43c1.txt',
10
// 可选：提交引擎（默认 Bing、Yandex）
11
engines: ['bing', 'yandex'],
12
// engines: ['bing']
13
})
```
- 这么操作完后，每次执行pnpm run build，即可自动提交 IndexNow 插件（本地执行不会推送哦）

🎨 Firefly 主题特色功能#

1. 双侧边栏布局#

Firefly 支持单侧边栏和双侧边栏配置，可以放置日历、目录、音乐播放器等组件。

2. 多种文章布局#

支持列表布局、网格布局、瀑布流布局，可在配置文件中自由切换。

3. 个性化配置#

主题色自定义（360° 色相调节）
亮暗色模式自动切换
自定义字体和壁纸
樱花飘落等动画特效

4. 功能丰富#

全文搜索（Pagefind）
文章置顶和推荐
评论系统集成
友链和相册功能

💡 迁移注意事项#

备份数据：迁移前务必备份 Hexo 博客的所有文件
URL 重定向：如果文章 URL 结构变化，需要配置重定向规则
评论迁移：如果使用 Disqus 等评论系统，需要迁移评论数据
SEO 保留：确保文章的永久链接不变，或设置 301 重定向
测试验证：迁移后全面测试各项功能是否正常

📝 总结#

从 Hexo 迁移到 Astro Firefly 是一次非常愉快的体验：

开发体验提升：热更新速度极快，TypeScript 支持完善
性能大幅提升：首屏加载时间减少了 60%+
功能更加丰富：Firefly 主题提供了很多开箱即用的功能
部署更加便捷：Vercel 和 Cloudflare 都提供了很好的支持

如果你也在考虑迁移博客，不妨试试 Astro Firefly，相信你会喜欢上它的！

项目地址#

Firefly 主题：https://github.com/CuteLeaf/Firefly
在线预览：https://blog.huhaha.vip/
使用文档：https://docs-firefly.cuteleaf.cn/

互动时间#

你现在使用的是什么博客框架？有没有考虑过迁移？欢迎在评论区分享你的想法！

如果你在迁移过程中遇到了什么问题，也可以在评论区留言，我会尽力帮助你！

推荐阅读：

（注：文章部分信息来源于 Firefly 官方文档和个人迁移经验）

上班摸鱼神器！这个工具让老板以为你在疯狂加班

2026-05-21T00:00:00.000Z

👨💻 打工人摸鱼神器！老板再也看不出你在划水！#

作为一名合格的打工人，摸鱼是必备技能。但是——

老板突然走到身后怎么办？
同事投来好奇的目光怎么办？
工作完成了想刷会儿手机怎么办？

别慌！今天给大家推荐一个神器——Genact，让你的终端秒变”高端工作现场”！

🎭 什么是 Genact？#

Genact 是一个开源的终端”演戏”工具，它能模拟各种工作场景：

🚀 代码编译中…
📥 大型文件下载…
💻 系统启动日志…
🔐 黑客破解界面…
🐧 Linux 内核编译…

运行之后，你的终端会疯狂输出各种专业的内容，看起来就像在执行什么超级复杂的任务！

🎬 场景演示效果#

场景1：代码编译模式#

1
[COMPILER] 正在编译 Linux 内核...
2
[CC] arch/x86/kernel/entry_64.o
3
[CC] arch/x86/kernel/process_64.o
4
[CC] arch/x86/kernel/ptrace_64.o
5
[LD] vmlinux.o
6
  OBJCOPY arch/x86/boot/compressed/vmlinux
7
  Building, stage 2... [78%]

场景2：黑客破解模式#

1
[HACKER] 正在入侵主服务器...
2
[SCAN] 端口扫描中... 22, 80, 443, 3306...
3
[CIPHER] 正在破解 RSA-2048 加密...
4
[ROOT] 获取管理员权限成功！
5
[UPLOAD] 正在上传数据... [████████████████] 94%

场景3：系统启动模式#

1
[BIOS] Phoenix SecureCore(tm) Setup Utility
2
[POST] 内存检测: 16384MB OK
3
[GRUB] Loading Linux 6.5.0-rc1...
4
[INIT] 挂载根文件系统...
5
[NETWORK] eth0: 192.168.1.100/24
6
[LOGIN] 欢迎来到 Ubuntu 22.04 LTS

🚀 全平台安装教程#

Windows 用户#

方法1：使用 Scoop 安装（推荐）

Terminal window

1
# 如果没有安装 Scoop，先安装
2
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3
iwr -useb get.scoop.sh | iex
4

5
# 安装 Genact
6
scoop install genact

方法2：下载预编译二进制

访问 GitHub Releases
下载 genact-1.5.1-x86_64-pc-windows-msvc.exe
直接双击运行即可

macOS 用户#

方法1：使用 Homebrew 安装（推荐）

Terminal window

1
brew install genact

方法2：使用 Port 安装（推荐）

Terminal window

1
sudo port install genact

Linux 用户#

通用方法 - 从 GitHub Releases 安装（推荐）

Terminal window

1
chmod +x genact-linux
2
./genact-linux

🎮 使用指南#

基本用法#

Terminal window

1
# 直接运行（随机场景）
2
genact
3

4
# 指定场景运行
5
genact --scenario compiler
6
genact --scenario download
7
genact --scenario boot
8
genact --scenario hacker

可选参数#

Terminal window

1
# 列出所有可用场景
2
genact --list
3

4
# 静音模式（无声音）
5
genact --quiet
6

7
# 指定速度（slow/normal/fast）
8
genact --speed fast
9

10
# 随机切换场景
11
genact --random

场景列表#

场景名称	效果描述
`compiler`	模拟代码编译
`download`	模拟文件下载
`boot`	模拟系统启动
`hacker`	黑客破解界面
`matrix`	黑客帝国数字雨
`antivirus`	杀毒软件扫描
`coffee`	咖啡机制作中
`simcity`	SimCity 城市建造
`weather`	天气播报
`cow`	会说话的牛

⚠️ 使用注意事项#

演技要到位：不要盯着屏幕傻笑，假装很专注的样子
音量控制：某些场景会有声音效果，记得静音
适度使用：摸鱼虽好，可不要贪杯哦
团队氛围：如果团队氛围好可以玩玩，严肃场合慎用

🎉 我的使用体验#

用了 Genact 之后：

✅ 安全感提升：老板路过再也不慌了
✅ 同事羡慕：“你在编译什么大型项目？”
✅ 趣味性增加：工作之余多了很多乐趣
✅ 完全无害：只是模拟输出，不执行任何操作

📦 项目地址#

GitHub：https://github.com/svenstaro/genact
Star 数：⭐ 10k+

💬 互动时间#

你平时上班怎么摸鱼？有没有被老板抓到过？
使用 Genact 后有什么搞笑的经历？

欢迎在评论区分享你的故事！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

替代Notion的最佳选择！这个开源工具太惊艳了

2026-05-15T00:00:00.000Z

朋友们！寻找 Notion 替代品的看过来！#

Notion 虽然好用，但服务器在国外，访问速度慢；而且数据存在别人那里，总觉得不安全；最重要的是，免费版功能有限…

今天给大家推荐一个神器——AFFiNE，一个完全开源的笔记和协作工具。用了它之后，我果断放弃了 Notion！

什么是 AFFiNE？#

AFFiNE 是一个完全开源的笔记和协作工具，集文档管理、白板协作、任务管理于一体，数据本地化，安全可靠。

为什么推荐 AFFiNE？#

1️⃣ 完全开源#

代码完全开源，你可以自己部署，数据安全有保障。

2️⃣ 功能强大#

集文档管理、白板协作、任务管理于一体，功能不输 Notion。

3️⃣ 数据本地化#

所有数据都存在本地，不用担心隐私泄露。

4️⃣ 离线可用#

支持离线使用，随时随地都能工作。

5️⃣ 颜值在线#

界面设计非常现代简洁，使用体验很棒。

如何使用 AFFiNE？#

步骤1：下载并安装 AFFiNE#

首先，你需要下载并安装 AFFiNE。AFFiNE 支持 Docker 部署，这是最简单的方式。

步骤2：配置 Docker Compose#

创建一个 docker-compose.yml 文件，内容如下：

1
name: affine
2
services:
3
  affine:
4
    image: ghcr.io/toeverything/affine:${AFFINE_REVISION:-stable}
5
    container_name: affine_server
6
    ports:
7
      - '${PORT:-3010}:3010'
8
    depends_on:
9
      redis:
10
        condition: service_healthy
11
      postgres:
12
        condition: service_healthy
13
      affine_migration:
14
        condition: service_completed_successfully
15
    volumes:
16
      # custom configurations
17
      - ${UPLOAD_LOCATION}:/root/.affine/storage
18
      - ${CONFIG_LOCATION}:/root/.affine/config
19
    env_file:
20
      - .env
21
    environment:
22
      - REDIS_SERVER_HOST=redis
23
      - DATABASE_URL=postgresql://${DB_USERNAME}:${DB_PASSWORD}@postgres:5432/${DB_DATABASE:-affine}
24
      - AFFINE_INDEXER_ENABLED=false
25
    restart: unless-stopped
26

27
  affine_migration:
28
    image: ghcr.io/toeverything/affine:${AFFINE_REVISION:-stable}
29
    container_name: affine_migration_job
30
    volumes:
31
      # custom configurations
32
      - ${UPLOAD_LOCATION}:/root/.affine/storage
33
      - ${CONFIG_LOCATION}:/root/.affine/config
34
    command: ['sh', '-c', 'node ./scripts/self-host-predeploy.js']
35
    env_file:
36
      - .env
37
    environment:
38
      - REDIS_SERVER_HOST=redis
39
      - DATABASE_URL=postgresql://${DB_USERNAME}:${DB_PASSWORD}@postgres:5432/${DB_DATABASE:-affine}
40
      - AFFINE_INDEXER_ENABLED=false
41
    depends_on:
42
      postgres:
43
        condition: service_healthy
44
      redis:
45
        condition: service_healthy
46

47
  redis:
48
    image: redis
49
    container_name: affine_redis
50
    healthcheck:
51
      test: ['CMD', 'redis-cli', '--raw', 'incr', 'ping']
52
      interval: 10s
53
      timeout: 5s
54
      retries: 5
55
    restart: unless-stopped
56

57
  postgres:
58
    image: pgvector/pgvector:pg16
59
    container_name: affine_postgres
60
    volumes:
61
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
62
    environment:
63
      POSTGRES_USER: ${DB_USERNAME}
64
      POSTGRES_PASSWORD: ${DB_PASSWORD}
65
      POSTGRES_DB: ${DB_DATABASE:-affine}
66
      POSTGRES_INITDB_ARGS: '--data-checksums'
67
      # you better set a password for you database
68
      # or you may add 'POSTGRES_HOST_AUTH_METHOD=trust' to ignore postgres security policy
69
      POSTGRES_HOST_AUTH_METHOD: trust
70
    healthcheck:
71
      test:
72
        ['CMD', 'pg_isready', '-U', "${DB_USERNAME}", '-d', "${DB_DATABASE:-affine}"]
73
      interval: 10s
74
      timeout: 5s
75
      retries: 5
76
    restart: unless-stopped

展开收起

步骤3：配置环境变量#

创建一个 .env 文件，内容如下：

1
AFFINE_REVISION=stable
2

3
PORT=3010
4

5
DB_DATA_LOCATION=./pgdata
6
UPLOAD_LOCATION=./storage
7
CONFIG_LOCATION=./config
8

9
# 数据库链接信息,必填
10
DB_USERNAME=affine
11
DB_PASSWORD=affine
12
DB_DATABASE=affine

步骤4：启动 AFFiNE#

在终端中运行以下命令启动 AFFiNE：

Terminal window

1
docker-compose up -d

步骤5：访问 AFFiNE#

打开浏览器，访问 http://localhost:3010，会自动跳转到注册页面，注册完成后会登录到后台管理页面，你就可以看到 AFFiNE 的界面了。

步骤5：登录管理后台#

注册账号后，你就可以登录管理后台了,进行个性化配置

步骤6：开始使用#

访问 http://localhost:3010，你就可以开始创建文档、使用白板、管理任务了。先设置一下中文语言~~（习惯英语的可以忽略）~~，然后就可以开始愉快的写文档了，再页不用担心隐私问题。

步骤7：生成脑图#

并且还支持文档转脑图功能，你可以将文档转换为脑图，方便组织和分享知识。

常见问题#

Q: AFFiNE 和 Notion 有什么区别？ A: AFFiNE 是开源的，数据本地化，更安全；Notion 是商业软件，数据存在云端。

Q: AFFiNE 支持哪些功能？ A: AFFiNE 支持文档编辑、白板协作、任务管理、知识关联等多种功能。

Q: AFFiNE 可以离线使用吗？ A: 可以，AFFiNE 支持离线使用，随时随地都能工作。

Q: AFFiNE 可以多人协作吗？ A: 可以，AFFiNE 支持多人实时协作，可以共享文档和白板。

我的使用体验#

我使用 AFFiNE 已经两个月了，效果真的非常好：

界面简洁美观，使用体验很棒
功能强大，集文档、白板、任务于一体
数据本地化，不用担心隐私问题
离线可用，随时随地都能工作
完全免费开源，没有任何广告和限制

适合谁用？#

学生党：整理学习笔记，构建知识体系
职场人士：管理工作文档，协作办公
团队协作：需要一个统一的协作平台
隐私敏感者：不想把数据存在第三方平台
任何人：想要一个强大的笔记和协作工具

注意事项#

首次启动需要初始化：第一次启动 AFFiNE 时，需要初始化数据库，可能需要一些时间，请耐心等待。
定期备份数据：建议定期备份笔记数据，防止数据丢失。

项目地址#

如果你对 AFFiNE 感兴趣，可以访问它的 GitHub 仓库：https://github.com/toeverything/AFFiNE

互动时间#

你平时用什么笔记软件？有没有遇到过什么痛点？使用 AFFiNE 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

国产笔记软件之光！这个工具让Notion黯然失色

2026-05-15T00:00:00.000Z

朋友们！想要国产笔记软件的看过来！#

Notion 服务器在国外，访问慢；数据存在云端，不安全；或者想要一个国产的、数据本地化的笔记软件…

今天给大家推荐一个神器——AppFlowy，一个完全开源的国产笔记软件。用了它之后，我果断放弃了 Notion！

什么是 AppFlowy？#

AppFlowy 是一个完全开源的国产笔记软件，数据本地化，功能强大，界面美观，是 Notion 的绝佳替代品。

为什么推荐 AppFlowy？#

1️⃣ 国产之光#

由国内团队开发，完全自主可控。

2️⃣ 数据本地化#

所有数据都存储在本地，不用担心隐私泄露。

3️⃣ 功能强大#

支持文档编辑、白板协作、任务管理等功能。

4️⃣ 界面美观#

界面设计现代简洁，使用体验很棒。

5️⃣ 完全开源#

代码完全开源，免费使用。

如何使用 AppFlowy？#

步骤1：下载并安装 AppFlowy#

首先，你需要下载并安装 AppFlowy。访问 AppFlowy 的下载页面，下载适合你系统的版本。

步骤2：安装 AppFlowy#

运行安装程序，按照提示完成安装。安装过程非常简单，几分钟就能搞定。

步骤3：启动 AppFlowy#

安装完成后，启动 AppFlowy，你就可以看到它的主界面了。

步骤4：开始使用#

创建文档、使用白板、管理任务，AppFlowy 可以满足你的所有需求。

常见问题#

Q: AppFlowy 和 Notion 有什么区别？ A: AppFlowy 是国产软件，数据本地化，更安全；Notion 是商业软件，数据存在云端。

Q: AppFlowy 支持哪些功能？ A: AppFlowy 支持文档编辑、白板协作、任务管理、知识关联等多种功能。

Q: AppFlowy 可以离线使用吗？ A: 可以，AppFlowy 的所有功能都可以离线使用。

Q: AppFlowy 支持多平台吗？ A: 支持，AppFlowy 支持 Windows、macOS、Linux、iOS、Android 等多种平台。

我的使用体验#

我使用 AppFlowy 已经两个月了，效果真的非常好：

界面美观，使用体验很棒
功能强大，集文档、白板、任务于一体
数据本地化，不用担心隐私问题
完全免费开源，没有任何广告和限制
国产软件，支持国产开源

适合谁用？#

学生党：整理学习笔记，构建知识体系
职场人士：管理工作文档，协作办公
团队协作：需要一个统一的协作平台
隐私敏感者：不想把数据存在第三方平台
任何人：想要一个强大的笔记和协作工具

注意事项#

首次使用需要适应：界面和 Notion 略有不同，需要一点时间适应。
定期备份数据：建议定期备份笔记数据，防止数据丢失。

项目地址#

如果你对 AppFlowy 感兴趣，可以访问它的 GitHub 仓库：https://github.com/AppFlowy-IO/AppFlowy

互动时间#

你平时用什么笔记软件？有没有遇到过数据安全的问题？使用 AppFlowy 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

极简备忘录神器！这个工具让记录变得简单

2026-05-15T00:00:00.000Z

朋友们！想要极简备忘录工具的看过来！#

市面上的备忘录软件功能太复杂，很多功能用不到；或者想要一个简单纯粹的记录工具…

今天给大家推荐一个神器——Memos，一个极简的备忘录工具。用了它之后，记录变得前所未有的简单！

什么是 Memos？#

Memos 是一个极简的备忘录工具，专注于记录和分享，没有多余的功能，让你专注于内容本身。

为什么推荐 Memos？#

1️⃣ 极简设计#

界面简洁，没有多余的功能，专注记录。

2️⃣ Markdown 支持#

支持 Markdown 格式，让笔记更加美观。

3️⃣ 轻松分享#

一键分享笔记，支持生成链接。

4️⃣ 部署简单#

用 Docker 一键就能部署，几分钟搞定。

5️⃣ 完全开源#

代码完全开源，免费使用。

如何使用 Memos？#

步骤1：下载并安装 Memos#

首先，你需要下载并安装 Memos。Memos 支持 Docker 部署，这是最简单的方式。

步骤2：配置 Docker Compose#

创建一个 docker-compose.yml 文件，内容如下：

1
services:
2
  memos:
3
    image: neosmemo/memos:stable
4
    container_name: memos
5
    restart: unless-stopped
6
    ports:
7
      - "5230:5230"
8
    volumes:
9
      - ./data:/var/opt/memos
10
    environment:
11
      MEMOS_PORT: 5230
12
      MEMOS_DRIVER: sqlite
13
      # 设置为公共网址MEMOS_INSTANCE_URL
14
      MEMOS_INSTANCE_URL: https://memos.example.com

步骤3：启动 Memos#

在终端中运行以下命令启动 Memos：

Terminal window

1
docker-compose up -d

步骤4：访问 Memos#

打开浏览器，访问 http://localhost:5230，你就可以看到 Memos 的界面了。

注意：首次运行时，第一个用户将成为主机管理员，可以配置注册、认证、存储及其他全局设置。一定要记录好密码哦。

步骤5：开始记录#

输入账号密码后会进入首页，点击新建按钮，开始记录你的笔记。支持 Markdown 格式，让笔记更加美观。

如果不想docker部署，怎么办#

当你不想在栈里用 Docker 或已经直接在主机上管理服务时，可以直接以安装文件安装 Memos。#

支持的平台：

Linux: amd64、arm64、armv7
macOS: 英特尔和苹果芯片
Windows: amd64

下载地址：https://github.com/usememos/memos/releases/

常见问题#

Q: Memos 支持 Markdown 吗？ A: 支持，Memos 完全支持 Markdown 格式。

Q: Memos 可以分享笔记吗？ A: 可以，Memos 支持一键分享，生成分享链接。

Q: Memos 可以离线使用吗？ A: 可以，Memos 的所有功能都可以离线使用。

Q: Memos 的数据存储在哪里？ A: Memos 的数据存储在本地，你可以自己备份和管理。

我的使用体验#

我使用 Memos 已经一段时间了，效果真的非常好：

界面简洁，没有多余的功能，专注记录
支持 Markdown，笔记更加美观
部署简单，几分钟就能搞定
数据本地化，不用担心隐私问题
完全免费开源，没有任何广告和限制

适合谁用？#

学生党：记录学习笔记
职场人士：记录工作事项
写作者：记录灵感和想法
任何人：想要一个简单的笔记工具

注意事项#

定期备份数据：建议定期备份笔记数据，防止数据丢失。
注意数据安全：虽然数据存储在本地，但也要注意数据安全。

项目地址#

如果你对 Memos 感兴趣，可以访问它的 GitHub 仓库：https://github.com/usememos/memos

互动时间#

你平时用什么笔记工具？有没有遇到过功能太复杂的问题？使用 Memos 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

隐私保护搜索引擎！这个工具让你的搜索更安全

2026-05-15T00:00:00.000Z

朋友们！担心搜索隐私泄露的看过来！#

使用搜索引擎时，搜索历史被记录，隐私得不到保护；或者想要一个不追踪用户的搜索引擎…

今天给大家推荐一个神器——SearXNG，一个完全开源的隐私保护搜索引擎。用了它之后，我的搜索终于安全了！

什么是 SearXNG？#

SearXNG 是一个分布式的元搜索引擎，用户可以通过它在多个搜索引擎中同时查询，而不会暴露自己的隐私。它是对原始 Searx 项目的分支，改进了性能、功能和用户体验。

元搜索引擎：SearXNG 并不直接提供搜索结果，而是将用户的查询分发到多个搜索引擎（如 Google、Bing、DuckDuckGo 等），然后汇总这些结果。
开源：SearXNG 是完全开源的，任何人都可以自由下载、修改和部署。
注重隐私：它不会保存用户的 IP 地址、搜索历史或其他个人信息。

为什么推荐 SearXNG？#

1️⃣ 隐私保护#

不追踪用户，不记录搜索历史，保护隐私。

2️⃣ 多引擎聚合#

聚合多个搜索引擎的结果，提供更全面的搜索结果。

3️⃣ 完全开源#

代码完全开源，你可以自己部署，安全可靠。

4️⃣ 部署简单#

用 Docker 一键就能部署，几分钟搞定。

5️⃣ 完全免费#

没有任何费用，永久免费使用。

如何使用 SearXNG？#

步骤1：下载并安装 SearXNG#

首先，你需要下载并安装 SearXNG。SearXNG 支持 Docker 部署，这是最简单的方式。

步骤2：配置 Docker Compose#

创建一个 docker-compose.yml 文件，内容如下：

1
# Read the documentation before using the `docker-compose.yml` file:
2
# https://docs.searxng.org/admin/installation-docker.html
3

4
name: searxng
5

6
services:
7
  core:
8
    container_name: searxng-core
9
    image: docker.io/searxng/searxng:${SEARXNG_VERSION:-latest}
10
    restart: always
11
    ports:
12
      - ${SEARXNG_HOST:+${SEARXNG_HOST}:}${SEARXNG_PORT:-8080}:${SEARXNG_PORT:-8080}
13
    env_file: ./.env
14
    volumes:
15
      - ./core-config/:/etc/searxng/:Z
16
      - core-data:/var/cache/searxng/
17

18
  valkey:
19
    container_name: searxng-valkey
20
    image: docker.io/valkey/valkey:9-alpine
21
    command: valkey-server --save 30 1 --loglevel warning
22
    restart: always
23
    volumes:
24
      - valkey-data:/data/
25

26
volumes:
27
  core-data:
28
  valkey-data:

展开收起

创建一个.env文件，内容如下：

Terminal window

1
# Use a specific version tag. E.g. "latest" or "2026.3.25-541c6c3cb".
2
#SEARXNG_VERSION=latest
3

4
# 监听ip
5
#SEARXNG_HOST=[::]
6

7
# 启动端口
8
SEARXNG_PORT=8080

步骤3：启动 SearXNG#

在终端中运行以下命令启动 SearXNG：

Terminal window

1
docker-compose up -d

步骤4：访问 SearXNG#

打开浏览器，访问 http://localhost:8080，你就可以看到 SearXNG 的界面了。

步骤5：开始搜索#

输入关键词，开始搜索吧！SearXNG 会聚合多个搜索引擎的结果。

常见问题#

Q: SearXNG 会追踪用户吗？ A: 不会，SearXNG 不追踪用户，不记录搜索历史。

Q: SearXNG 聚合哪些搜索引擎？ A: SearXNG 聚合 Google、Bing、DuckDuckGo 等多个搜索引擎。

Q: SearXNG 可以自定义吗？ A: 可以，SearXNG 支持自定义配置和主题。

Q: SearXNG 需要联网吗？ A: 需要，SearXNG 需要联网获取搜索结果。

我的使用体验#

搜索结果全面，聚合多个引擎
隐私保护，不用担心被追踪
界面简洁，使用体验很棒
部署简单，几分钟就能搞定
完全免费开源，没有任何广告和限制

适合谁用？#

隐私敏感者：担心搜索历史被记录
开发者：需要一个干净的搜索环境
任何人：想要一个隐私保护的搜索引擎

注意事项#

首次启动需要配置：第一次启动需要配置一些参数。
可能需要梯子：某些搜索引擎在国内访问可能受限（当然你可以只使用国内的搜索引擎）。

项目地址#

如果你对 SearXNG 感兴趣，可以访问它的 GitHub 仓库：https://github.com/searxng/searxng

互动时间#

你平时用什么搜索引擎？有没有担心过隐私问题？使用 SearXNG 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

揭秘！你刷到的热门短剧，可能都是这个软件做的

2026-05-15T00:00:00.000Z

前言#

你有没有刷到过这样的短视频？

画面精美、剧情紧凑、更新频繁，一看就是”专业团队”制作的。但你知道吗？很多爆款短剧其实是一个人用AI工具做出来的！

今天就来揭秘这个”爆款制造机”——Toonflow。那些让你欲罢不能的短剧，很可能就是用它做的！

以前做短剧需要编剧、导演、画师、剪辑师一整个团队，现在有了 Toonflow，一个人+一台电脑就能搞定，效率提升了10倍不止！

什么是 Toonflow？#

简单说，Toonflow 就是一个文字转视频的神器。你只需要输入文字描述，它就能自动帮你生成完整的视频。

核心功能：

✅ 输入想法，自动写剧本
✅ 剧本变画面，自动生成动画
✅ 一键加字幕、音效、背景音乐
✅ 支持多种风格（动漫、写实、古风都可以）

为什么推荐它？#

1️⃣ 新手也能上手#

完全不需要任何专业技能：

不用学 Premiere、After Effects
不用会画画、不用会剪辑
甚至不用出镜，纯文字就能做视频

2️⃣ 效率超高#

以前做一条视频：

写脚本：2小时
找素材：1小时
剪辑：3小时
加字幕音效：1小时
总计：7小时+

现在用 Toonflow：

输入想法：5分钟
等待生成：30分钟
总计：35分钟

效率提升了12倍！

3️⃣ 质量稳定#

AI 生成的内容质量很可靠：

画面风格统一
字幕自动生成
背景音乐搭配合理
节奏符合平台算法

4️⃣ 完全免费开源#

可以免费下载使用，还能自己改代码，开发者社区也很活跃。

手把手教你用 Toonflow#

第一步：下载安装#

打开浏览器，访问官网：https://toonflow.net/#/
点击”下载”按钮，选择适合你电脑的版本（Windows 或 Mac）
下载完成后，双击安装包，跟着提示一步步安装

第二步：配置 AI（很简单）#

第一次打开会提示配置 AI 服务，推荐选择”APIYI 一键配置”，跟着提示操作就行。如果有自己的 OpenAI API Key，也可以手动输入。

第三步：创建项目#

打开 Toonflow，点击”新建项目”
输入项目名称，比如”我的第一个视频”
选择模板：推荐”短视频模板”（适合抖音、快手）
选择画布大小：竖版 9<16>（手机全屏）

第四步：写剧本（核心步骤）#

在左侧工具栏找到”剧本”按钮，点击添加到画布上：

在输入框里写你的想法，比如：“做一个介绍人工智能的科普视频，1分钟左右，风格轻松有趣”
点击”生成”按钮，等待15秒左右
AI 会自动生成完整的剧本，包括台词、旁白、镜头提示

小技巧：写得越详细，生成的效果越好。比如可以指定人物、场景、风格。

第五步：生成分镜#

选中刚才生成的剧本，点击上方的”生成分镜”按钮：

等待20秒左右，会生成8-12张画面
每张画面都有详细的描述
可以点击画面更换风格（动漫风、写实风、古风等）

第六步：合成视频#

点击画布右上角的”合成”按钮：

选择分辨率：1080x1920（手机全屏）
选择输出格式：MP4（最常用）
点击”开始合成”，等待30-60秒
合成完成后可以预览效果

第七步：导出发布#

预览没问题后，点击”导出”按钮
选择保存位置，比如桌面
导出完成后，就可以上传到抖音、快手、B站等平台了

适合谁用？#

自媒体博主：快速产出内容，提高更新频率
职场人士：做产品介绍、培训视频
学生党：做课程作业、活动宣传
兴趣爱好者：记录生活、分享知识

总结#

Toonflow 是一个真正能帮普通人实现”文字转视频”的神器。它降低了视频创作的门槛，让每个人都能轻松做视频。

如果你也想尝试做短视频，但又怕麻烦，强烈推荐试试 Toonflow！

互动时间#

你平时喜欢看什么类型的短视频？如果让你做一个，你想做什么主题？欢迎在评论区分享！如果觉得这篇文章对你有帮助，别忘了点赞、在看、转发三连支持一下～

项目地址：https://github.com/HBAI-Ltd/Toonflow-app

官网：https://toonflow.net/#/

注：创作内容请遵守相关法律法规和版权规定。

文件格式转换太麻烦？这个工具支持多格式批量转换！

2026-05-15T00:00:00.000Z

朋友们！文件格式转换太麻烦的看过来！#

文件格式不兼容；转换工具太多太乱；想批量转换却没有好工具…

今天给大家推荐一个神器——Reubah，一个支持多格式转换及批量处理的工具。自从用了它，我的文件转换再也不头疼了！

什么是 Reubah？#

Reubah 是一个开源的文件格式转换工具，它支持多种格式转换和批量处理操作，让文件转换变得简单。

为什么推荐 Reubah？#

1️⃣ 多格式支持#

支持多种文件格式：

文档格式：DOC、DOCX、PDF、TXT等
图片格式：JPG、PNG、GIF、WebP等
音频格式：MP3、WAV、FLAC等
视频格式：MP4、AVI、MKV等

2️⃣ 批量处理#

一次转换多个文件：

支持批量选择文件
支持文件夹批量转换
可以设置输出格式

3️⃣ 在线转换#

无需安装软件：

支持Web端在线转换
支持Docker部署
随时随地使用

4️⃣ 简洁高效#

操作简单，转换快速：

简洁的界面设计
支持拖拽上传
转换速度快

5️⃣ 完全开源#

Reubah 是开源项目，完全免费使用：

代码透明可审计
支持自定义修改
使用简单方便

如何使用 Reubah？#

步骤1：部署 Reubah#

1
services:
2
  reubah:
3
    image: ghcr.io/dendianugerah/reubah:latest
4
    container_name: reubah
5
    ports:
6
      - "8081:8081"
7
    security_opt:
8
      - no-new-privileges:true
9
    cap_drop:
10
      - ALL
11
    restart: unless-stopped

步骤2：启动服务#

Terminal window

1
docker-compose up -d

步骤3：上传文件#

访问 http://localhost:8081，上传需要转换的文件。

步骤4：选择格式#

选择目标格式，点击转换。

常见问题#

Q: Reubah 需要什么配置？ A: Reubah 对硬件要求不高，建议至少 2GB 内存。

Q: 支持哪些格式转换？ A: 支持文档、图片、音频、视频等多种格式。

Q: 需要联网吗？ A: 自建部署的话可以离线使用。

Q: 可以批量转换吗？ A: 可以，支持批量转换多个文件。

适合谁用？#

办公人士：经常需要转换文件格式
学生：处理作业文件
开发者：转换代码文件
任何人：需要文件格式转换

注意事项#

文件大小：注意文件大小限制
转换时间：大文件转换需要时间
输出目录：注意设置输出目录

项目地址#

如果你对 Reubah 感兴趣，可以访问它的 GitHub 仓库：https://github.com/dendianugerah/reubah

互动时间#

你们平时怎么转换文件格式？有没有遇到过什么问题？使用 Reubah 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹

8MB 大小！这款 WSL 管理工具让我彻底告别命令行

2026-05-15T00:00:00.000Z

前言#

作为一个常年在 Windows 上写代码的开发者，WSL (Windows Subsystem for Linux) 是我离不开的神器。但说实话，管理 WSL 一直是个头疼的问题 —— 要么在 PowerShell 里敲命令，要么用 Windows Terminal，总觉得不够直观。

直到我发现了 WSL Dashboard，一款用 Rust + Slint 构建的 WSL 可视化管理工具，8MB 大小，颜值在线，功能强大，彻底改变了我的 WSL 使用体验！

为什么推荐它？#

1️⃣ 轻量到离谱#

你敢信？整个安装包只有 8MB！

启动速度飞快，秒开无压力
运行时内存占用仅 80MB 左右
基于 Rust 开发，性能炸裂
无冗余框架或依赖，老旧设备也能流畅运行

相比那些动辄几百 MB 的管理工具，这简直是股清流！

2️⃣ 颜值在线，体验丝滑#

WSL Dashboard 用 Slint 构建界面，视觉效果非常现代化：

简洁直观的图形界面，无需记忆命令行参数
操作流畅，响应迅速
支持多语言（中文、英文、日文等）
深色/浅色主题切换

3️⃣ 多发行版管理超方便#

如果你同时安装了 Ubuntu、Fedora、Arch 等多个 Linux 发行版，WSL Dashboard 能让你轻松管理：

快速切换默认发行版：一键设置常用环境
移动/导出/克隆发行版：灵活管理磁盘空间
开机自启动：通过 Windows 任务计划程序实现系统启动时自动运行 WSL
全局互斥锁：防止多发行版同时操作产生冲突

4️⃣ 实用功能一应俱全#

一键打开终端：支持自定义终端应用（Windows Terminal、PowerShell 等）
VS Code 集成：直接打开 WSL 中的项目
端口转发管理：可视化配置端口映射，局域网内访问 WSL 服务
USB 设备共享：将 USB 设备直通给 WSL 使用
自动化脚本：支持编写 Shell 脚本实现复杂任务

5️⃣ 安全可靠#

使用最小权限原则运行
支持按需提权机制
操作前会提示确认，防止误操作

我的使用体验#

用了 WSL Dashboard 一段时间后，最明显的感受是：

管理 WSL 变得轻松了：以前要记住一堆 wsl 命令，现在点点鼠标就搞定
磁盘空间可控了：可以直观看到每个发行版占用的空间，随时导出或清理
开发效率提升了：开机自动启动 WSL + 端口转发，不用再手动配置
颜值即正义：界面好看，用起来心情都好多了

怎么安装？#

访问 GitHub Releases 下载最新版本
解压后双击运行即可（绿色软件，无需安装）
首次运行会自动检测系统中的 WSL 发行版 系统要求：

Windows 10/11
已启用 WSL 功能

总结#

WSL Dashboard 绝对是 WSL 生态中的一款”瑞士军刀”，通过轻量化设计、自动化脚本支持和直观的图形界面，彻底改变了 WSL 的管理方式。无论是提升开发效率、简化系统管理，还是降低 Linux 使用门槛，它都是值得推荐的工具。

如果你也是 WSL 用户，强烈推荐试试这款工具，相信你会爱上它的！

互动时间#

你平时怎么管理 WSL？用命令行还是其他工具？欢迎在评论区分享你的经验！如果觉得这篇文章对你有帮助，别忘了点赞、在看、转发三连支持一下～

项目地址：https://github.com/owu/wsl-dashboard

注：WSL Dashboard 目前还在快速迭代中，部分功能可能还不够完善，但整体体验已经非常不错了！

又一个 Rust 神级编辑器！Fresh 让我放弃了 VS Code

2026-05-13T00:00:00.000Z

前言#

作为一个常年和代码打交道的程序员，我对编辑器的要求越来越高。VS Code 虽然好用，但总觉得有点臃肿；Neovim 很强大但配置太麻烦。直到我发现了 Fresh，一个用 Rust 写的新一代代码编辑器，彻底改变了我的开发体验。

今天就来给大家安利这个宝藏编辑器！

为什么我放弃了 VS Code？#

说实话，VS Code 陪伴了我很多年，但最近越来越觉得力不从心：

启动慢：每次打开大项目都要等好几秒
内存占用高：开几个窗口内存就飙升到 2-3GB
插件臃肿：为了功能装了一堆插件，反而拖慢速度
远程开发体验一般：SSH 连接经常卡顿

直到我遇到 Fresh，这些问题都迎刃而解！

Fresh 到底有多香？#

1️⃣ 性能炸裂，秒开秒关#

Fresh 用 Rust 编写，性能真的没话说：

启动速度：几乎瞬间打开，大项目也不卡顿
内存占用：比 VS Code 少一半以上
响应流畅：滚动、编辑、搜索都丝滑无比

2️⃣ 功能强大，应有尽有#

别以为轻量就功能少，Fresh 啥都有：

LSP 支持：智能补全、语法检查、定义跳转，一个不少
代码折叠：支持 LSP 折叠范围，代码结构一目了然
多光标编辑：批量修改神器
Live Grep：支持 ripgrep、git-grep，搜索超快
代码审查：内置 diff 查看器，代码对比很方便

3️⃣ 远程开发超方便#

这个功能我太爱了！Fresh 支持直接编辑远程服务器上的文件：

SSH 连接稳定，速度快
本地和远程无缝切换
文件系统抽象，操作和本地一样

4️⃣ 主题系统超灵活#

Fresh 的主题系统设计得很用心：

支持主题继承，可以基于内置主题自定义
有 4 个内置主题：light、dark、high-contrast、nostalgia
还能直接用终端配色，无缝融入你的终端环境

5️⃣ 插件生态正在崛起#

虽然年轻，但插件生态已经很丰富了：

支持 QuickJS 插件运行时
已有很多实用插件：代码 tour、git 集成、终端等
插件 API 设计合理，开发门槛不高

我的使用体验#

用了 Fresh 一周，我的感受是：

启动真的快：以前开 VS Code 要等 5 秒，现在几乎秒开
内存占用感人：同样打开一个 Rust 项目，VS Code 用了 1.2GB，Fresh 只用了 400MB
远程开发太香：连服务器写代码和本地没区别，再也不用 scp 来 scp 去了
界面简洁清爽：没有多余的按钮和菜单，专注于写代码

怎么安装？#

Fresh 支持所有主流平台：

Terminal window

1
# macOS
2
brew install fresh-editor
3

4
# Linux (Flatpak)
5
flatpak install flathub io.github.sinelaw.fresh
6

7
# Windows
8
scoop install fresh-editor
9
# or
10
winget install fresh-editor

或者直接从 GitHub Releases 下载对应平台的二进制文件。

总结#

Fresh 是一款非常有潜力的代码编辑器。它用 Rust 带来了极致的性能体验，同时功能也足够强大，完全能满足日常开发需求。如果你对 VS Code 的臃肿感到厌倦，又不想折腾 Neovim 的配置，Fresh 绝对值得一试！

目前 Fresh 还在快速迭代中，每周都有新功能上线。相信用不了多久，它就能成为主流编辑器的有力竞争者。

互动时间#

你平时用什么编辑器？最看重编辑器的什么功能？欢迎在评论区分享！如果觉得这篇文章对你有帮助，别忘了点赞、在看、转发三连支持一下～

项目地址：https://github.com/sinelaw/fresh

注：Fresh 目前还在快速发展中，部分功能可能还不够完善，但整体体验已经非常不错了！

Karpathy 出手了！这个插件让 Claude Code 瞬间变聪明

2026-05-12T00:00:00.000Z

前言#

最近在 Twitter 上看到 Andrej Karpathy 的一条推文，简直说出了所有用 AI 写代码的人的心声：

“模型会代你做错误假设，然后不假思索地执行。它们不管理自身的困惑，不寻求澄清，不呈现矛盾…”

相信很多人都有这样的经历：让 AI 写代码，它噼里啪啦写了一堆，看起来很完美，结果一运行全是坑。明明 100 行能搞定的事情，非要写成 1000 行的臃肿架构。

直到我发现了这个项目 —— andrej-karpathy-skills，一个专门解决这些问题的 Claude Code 插件。

为什么 AI 写代码容易踩坑？#

Karpathy 总结了几个核心问题：

想当然：AI 会默默做错误假设，然后直接执行
过度设计：喜欢堆砌抽象概念，把简单问题复杂化
手欠：经常改动或删除自己不理解的代码和注释
不验证：做完就完了，不管结果对不对

这些问题真的太戳心了！每次用 AI 写完代码，我都要花大量时间去 debug，有时候还不如自己写。

四个原则，让 AI 变靠谱#

这个项目提出了四个核心原则，专门针对这些问题：

1️⃣ 编码前先思考#

AI 最喜欢做的事情就是瞎猜。这个原则强制它：

明确说明假设，如果不确定就问
遇到歧义时，给出多种解释，不要默默选择
困惑时停下来，要求澄清

简单说就是：先想清楚再动手！

2️⃣ 简洁优先#

对抗 AI 的过度工程倾向：

不要添加要求之外的功能
不要为一次性代码创建抽象
如果 200 行能写成 50 行，重写它

检验标准：资深工程师会觉得这过于复杂吗？ 如果是，简化！

3️⃣ 精准修改#

这个太重要了！AI 经常手欠改一些无关的代码。这个原则要求：

只碰必须碰的代码
不要”改进”相邻的代码、注释或格式
不要重构没坏的东西
匹配现有风格，即使你不喜欢

检验标准：每一行修改都能直接追溯到用户的请求。

4️⃣ 目标驱动执行#

把模糊的指令变成可验证的目标：

“添加验证” → “为无效输入编写测试，然后让它们通过”
“修复 bug” → “编写重现 bug 的测试，然后让它通过”

这样 AI 就能自己循环执行，直到达成目标。

怎么用？#

方式一：Claude Code 插件（推荐）#

在 Claude Code 中执行两条命令就行：

1
/plugin marketplace add forrestchang/andrej-karpathy-skills
2
/plugin install andrej-karpathy-skills@karpathy-skills

安装后，这些指南会自动应用到你所有的项目中。

方式二：Trae 编辑器规则#

如果你使用 Trae 编辑器，可以直接将 CLAUDE.md 的内容添加到你的规则中：

在 Trae 中创建或编辑你的规则文件（通常在 .trae/rules/ 目录下）
访问 CLAUDE.md 获取完整内容
将内容复制到你的规则文件中

这样 Trae 的 AI 助手也会遵循这四个原则来帮你写代码。

方式三：按项目配置#

在项目根目录创建 CLAUDE.md 文件：

Terminal window

1
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

这种方式适合需要针对特定项目定制规则的场景。

我的使用体验#

用了几天之后，最明显的感受是：

AI 变”谨慎”了：遇到不确定的地方会主动问，不会瞎猜
代码简洁了：不再有一堆没用的抽象，该多少行就多少行
改动精准了：diff 里只有我要求的改动，没有乱七八糟的”顺手改进”
验证意识强了：写完代码会自己跑测试，直到通过

总结#

这个插件真的是用 AI 写代码的神器！它不是让 AI 写得更快，而是让 AI 写得更准、更稳、更符合人类工程师的思维方式。

四个原则看似简单，但直击 AI 编码的痛点。如果你经常用 Claude Code 写代码，强烈推荐试试这个插件，会让你的开发体验提升一个档次！

互动时间#

你平时用 AI 写代码时遇到过哪些坑？欢迎在评论区分享！如果觉得这篇文章对你有帮助，别忘了点赞、在看、转发三连支持一下～

项目地址：https://github.com/forrestchang/andrej-karpathy-skills

挖到宝了！这工具把下载、学习、阅读全搞定，我直接卸载了3个软件

2026-05-11T00:00:00.000Z

前言#

最近发现一个神仙工具，用了一周我直接把电脑里的视频播放器、电子书阅读器、音乐播放器都卸载了，就留这一个就够了！今天必须把这个宝藏工具安利给你们——OmniGet。

说实话，之前我电脑里软件多到爆炸：看视频用 PotPlayer，读书用 Kindle，听音乐用网易云，下载用 IDM，学课程还要开浏览器… 切换来切换去真的烦死了。直到我遇到 OmniGet，一个软件搞定所有，简直是效率神器！

为什么我强烈推荐？#

1️⃣ 下载功能强到离谱#

最开始吸引我的是它的下载能力，简直是无所不能：

视频平台全覆盖：YouTube、B站、抖音、小红书、TikTok、Instagram、Twitter… 你能想到的视频网站它都支持，复制链接就能下
课程下载是真的香：Udemy、Hotmart 这些平台的课程，登录一次就能批量下载，还能在软件里直接看，笔记能绑定时间戳，复习的时候点笔记就跳转到对应位置
种子和 P2P 都支持：磁力链接直接拖进去就行，两台电脑之间用4个词的密码就能传文件，太方便了

2️⃣ 内置播放器真的好用#

下载完不用切换软件，直接在里面看：

课程播放器：进度记忆、倍速播放、时间戳笔记，PDF 附件还能并排显示，学习体验拉满
电子书阅读器：支持 PDF、EPUB、漫画，有专注模式和护眼主题，做笔记和高亮都很方便
音乐播放器：像 iTunes 一样展示专辑封面，支持同步歌词，还能接入 Spotify，一个播放器搞定所有音乐

3️⃣ 细节做得特别贴心#

这些小功能真的戳到我了：

全局快捷键：Ctrl+Shift+D 一键下载剪贴板里的链接，不用打开软件
番茄钟：学累了自动暂停视频，劳逸结合
14 个主题：Catppuccin、Dracula 这些热门主题都有，颜值党狂喜
跨平台：Windows、macOS、Linux 都能用，而且是便携版，U盘一插就能带走

我的使用体验#

说说我这几天的真实感受：

下载课程：把 Udemy 上买的一门 Python 课程下载下来，大概50节课，边看边做笔记，复习的时候点击笔记就跳转到当时的知识点，效率提升太多了
看电子书：把之前下载的一堆 PDF 丢进去，自动识别封面和书名，专注模式下再也不会被其他软件打扰
听音乐：把本地音乐文件夹导入，自动整理成专辑视图，歌词同步滚动，比网易云还好用（关键是没广告！）

总结#

OmniGet 真的是我今年发现的最实用的工具，它不只是一个下载器，更像是一个一站式内容消费平台。从下载到学习到娱乐，一个软件全部搞定，大大减少了窗口切换的时间，让我能更专注地做事情。

最关键的是，它完全开源免费，没有任何广告，开发者也一直在更新维护。目前在 GitHub 上已经有 2000+ Star，口碑非常好。

如果你也像我一样，电脑里一堆软件，想要简化自己的数字生活，强烈推荐试试 OmniGet！

互动时间#

你平时电脑里最常用的工具是什么？有没有什么让你相见恨晚的神器？欢迎在评论区分享！如果觉得这篇文章对你有帮助，别忘了点赞、在看、转发三连支持一下～

项目地址：https://github.com/tonhowtf/omniget

GitHub 5.7k Star！DeepSeek-TUI，DeepSeek版的Claude Code来了

2026-05-08T00:00:00.000Z

前言#

嘿，小伙伴们！你在用 DeepSeek 网页版编程的时候，是不是总觉得哪里不对劲？让它改个文件还要复制粘贴，让它跑个命令还得手动执行，想让它管理 Git 更是难上加难。AI 的编程能力明明很强，但用起来效率却大打折扣，因为缺少那种”直接操控电脑”的体验。

直到最近发现了一个宝藏项目——DeepSeek-TUI！这是 DeepSeek 版的 Claude Code，一个跑在终端里的 AI 编程 Agent。能直接读写文件、执行 Shell 命令、管理 Git、甚至编排子 Agent 并行干活。说白了就是把 DeepSeek 的强大能力，直接搬进了你的 terminal！

今天我就来和大家唠唠这个神器，看看它是怎么让 AI 编程变得如此畅快的！

项目介绍#

✨ 核心特性#

🤖 终端原生: 跑在终端里的 AI 编程 Agent，键盘驱动，高效便捷
📝 文件操作: 读写文件、应用补丁、正则搜索，全部搞定
💻 Shell 执行: 运行命令、超时控制、后台任务管理
🔍 网页搜索: 集成 DuckDuckGo 搜索，AI 帮你查资料
📦 子 Agent: 编排多个子 Agent 并行工作，效率翻倍
🔄 Git 集成: 代码审查、补丁应用、差异分析
🌐 MCP 协议: 支持 Model Context Protocol，扩展无限
🔢 100万上下文: DeepSeek V4 的 100万 token 上下文，一次性看懂整个项目

🎮 多种工作模式#

模式	说明	适用场景
Normal	聊天模式，写文件和执行命令前询问	日常交流
Plan	只读模式，先探索代码库再规划方案	需求分析
Agent	多步工具调用，执行前询问 Shell	日常开发
YOLO	全自动模式，所有操作直接执行	快速出活
RLM	外部化上下文，适合大文件处理	大项目
Duo	player-coach 迭代验证模式	复杂任务

🛠️ 技术栈#

分类	技术
语言	Rust
TUI框架	Ratatui
AI模型	DeepSeek V4
协议	MCP (Model Context Protocol)
平台	macOS / Linux / Windows

实战体验#

安装配置#

安装方式超级简单，一行命令搞定：

Terminal window

1
# 方式一：npm 安装（推荐）
2
npm install -g deepseek-tui
3

4
# 方式二：Cargo 安装
5
cargo install deepseek-tui-cli --locked
6

7
# 国内用户建议配清华镜像
8
npm config set registry https://registry.npmmirror.com

获取 API Key#

访问 https://platform.deepseek.com 注册账号
在控制台创建一个 API Key（格式：sk-...）
首次运行时会提示输入 Key，或者手动设置：

Terminal window

1
# 方式一：环境变量
2
export DEEPSEEK_API_KEY=sk-your-key-here
3
echo 'export DEEPSEEK_API_KEY=sk-...' >> ~/.zshrc
4

5
# 方式二：配置文件
6
# ~/.deepseek/config.toml
7
[api]
8
key = "sk-your-key-here"

启动使用#

安装完成后，直接在终端输入：

Terminal window

1
deepseek

界面会立即启动，键盘驱动，操作流畅！

查看帮助#

按 F1 或输入 /help 查看所有命令：

Terminal window

1
# 常用命令
2
/help          # 显示帮助
3
/modes         # 查看所有模式
4
/exit          # 退出程序
5
/doctor         # 运行诊断

模式切换#

按 Tab 键循环切换模式：

1
Normal → Plan → Agent → YOLO → Normal

Terminal window

1
# 想先了解代码库？用 Plan 模式
2
# 输入："这个代码库是做什么的？"
3
# AI 会先分析项目结构，不做任何修改
4

5
# 想让它干活？切换到 Agent 模式
6
# 输入："帮我重构这个函数"
7
# AI 会一步步执行，每次执行 Shell 前都会询问

项目分析#

进入一个项目目录，让 AI 帮你分析：

Terminal window

1
cd ~/my-project
2
deepseek
3

4
# 问：这个代码库是做什么的？
5
# AI 会：
6
# 1. 分析项目结构
7
# 2. 读取关键配置文件
8
# 3. 总结项目功能
9
# 4. 给出目录结构说明

100万 token 上下文意味着 AI 可以一次性看完整个项目的所有代码，不需要你手动挑选要分析的文件！

代码修改#

想让 AI 帮你修改代码？太简单了！

Terminal window

1
# Agent 模式下
2
# 输入："把这个函数的错误处理完善一下"
3

4
# AI 会：
5
# 1. 读取源文件
6
# 2. 分析代码逻辑
7
# 3. 编写修改后的代码
8
# 4. 询问是否应用

Shell 命令执行#

AI 可以帮你执行各种 Shell 命令：

Terminal window

1
# 输入："运行一下测试用例"
2
# AI 会执行：npm test
3

4
# 输入："帮我启动开发服务器"
5
# AI 会执行：npm run dev
6

7
# 想看输出结果？实时显示！

子 Agent 并行工作#

这是高级功能，可以让多个 AI Agent 同时工作：

Terminal window

1
# 输入："帮我同时更新三个模块的依赖"
2
# AI 会：
3
# 1. 创建一个子 Agent 处理模块A
4
# 2. 创建一个子 Agent 处理模块B
5
# 3. 创建一个子 Agent 处理模块C
6
# 4. 协调三个 Agent 并行工作

网页搜索#

AI 可以帮你搜索网页获取信息：

Terminal window

1
# 输入："帮我查一下 Rust 最新版有什么新特性"
2
# AI 会使用 DuckDuckGo 搜索
3
# 返回搜索结果并总结

Git 操作#

集成 Git 功能，代码管理更方便：

Terminal window

1
# 输入："查看最近的提交"
2
# AI 执行 git log 并分析
3

4
# 输入："帮我审查这个 PR"
5
# AI 分析代码变更并给出建议
6

7
# 输入："应用这个补丁"
8
# AI 执行 git apply

费用追踪#

每次对话都会显示 token 消耗和费用：

1
对话费用：
2
├─ 输入 tokens: 1,234
3
├─ 输出 tokens: 567
4
├─ 费用: $0.0008
5
└─ 模型: deepseek-v4-flash

对比一下价格就知道有多实惠了：

模型	输入价格	输出价格
DeepSeek V4 Flash	$0.14/百万token	$0.28/百万token
Claude Sonnet	$3/百万token	$15/百万token
差距	21倍便宜	53倍便宜

我的使用感受#

作为一个每天要在终端里干活的开发者，我必须说 DeepSeek-TUI 彻底改变了我的编程方式。以前用网页版 AI 辅助编程，效率真的很低——让 AI 看代码要复制粘贴，让 AI 改代码要手动复制回来，让 AI 执行命令更是想都别想。

现在有了 DeepSeek-TUI，我直接在终端里和 AI 对话，让它读写文件、执行命令、管理 Git。要分析整个项目？100万 token 上下文直接搞定，不用手动挑文件。要改代码？AI 一步步来，每次操作都清清楚楚，我可以随时介入或批准。

最让我惊喜的是子 Agent 功能！上次让三个子 Agent 同时处理三个模块的依赖更新，效率直接翻了三倍。而且价格还这么便宜，用 Claude 要花的钱，用 DeepSeek 够用好几个月了！

项目资源#

GitHub地址: https://github.com/Hmbown/DeepSeek-TUI

官网地址: https://deepseek-tui.com

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: DeepSeek 版的 Claude Code，终端原生 AI 编程 Agent，100万 token 上下文，多种工作模式支持，价格实惠。

互动时间#

你是不是已经跃跃欲试了？赶紧安装 DeepSeek-TUI，体验一下终端里 AI 编程的畅快感吧！

如果你用了之后有什么有趣的体验，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的 AI 工具，记得关注我哦！

HexHub：程序员和运维的“瑞士军刀” Navicat+Xshell+XFtp+Docker一站替代

2026-05-08T00:00:00.000Z

前言#

嘿，小伙伴们！作为开发者和运维人员，每天是不是要在各种工具之间来回切换？SSH连接服务器要用Xshell，数据库管理要用Navicat，Docker管理又要用Portainer，SFTP传文件还要打开FileZilla…窗口开得比代码还多，找个工具半天找不到，效率低得让人抓狂！

直到最近发现了一个宝藏工具——HexHub！这是一款专门为程序员和运维人员打造的一站式开发运维利器，把数据库、Docker、SSH、SFTP等功能全部集成在一个软件里。一个窗口搞定所有操作，简直就是为我们量身定制的神器！

今天我就来和大家唠唠这个神奇的工具，看看它是怎么让开发运维变得如此轻松的！

项目介绍#

✨ 核心特性#

🎯 一站式集成: Database、Docker、SSH、SFTP，All in One！
🌐 跨平台支持: Windows、macOS、Linux，全平台可用
🎨 双主题设计: 亮色/暗色主题，保护你的眼睛
🚀 专业功能: 分屏广播输入、跨服务器文件传输、实时面板
💰 免费可用: 社区版完全免费，核心功能一应俱全

📦 支持的数据库#

数据库类型	支持版本
MySQL	✅
PostgreSQL	✅
SQLite	✅
SQL Server	✅
Oracle	✅
Redis	✅
ClickHouse	✅
MariaDB	✅
达梦	✅
人大金仓	✅
OpenGauss	✅
OceanBase	✅
PolarDB	✅

🛠️ 主要功能模块#

1
┌─────────────────────────────────────────┐
2
│              HexHub                     │
3
├──────────────┬──────────────────────────┤
4
│   Database   │  SQL查询、表结构编辑      │
5
│              │  数据同步、数据字典导出   │
6
├──────────────┼──────────────────────────┤
7
│    SSH      │  终端连接、跳板机         │
8
│              │  X11转发、分屏广播输入   │
9
├──────────────┼──────────────────────────┤
10
│    SFTP     │  文件上传下载、权限管理   │
11
│              │  跨服务器文件传输        │
12
├──────────────┼──────────────────────────┤
13
│   Docker    │  容器管理、镜像管理       │
14
│              │  容器终端、日志查看      │
15
└──────────────┴──────────────────────────┘

展开收起

实战体验#

下载安装#

首先，去官网下载安装包：

官网地址: https://www.hexhub.cn/

支持三大平台：

Windows: .exe 安装包
macOS: .dmg 磁盘镜像
Linux: .deb / .rpm

SSH 连接服务器#

打开 HexHub，点击左侧「SSH」图标：

1
# 新建连接配置
2
├─ 名称: 生产服务器
3
├─ 主机: 192.168.1.100
4
├─ 端口: 22
5
├─ 用户名: root
6
└─ 认证方式: 密码/秘钥/交互式

分屏广播输入#

管理多台服务器时，这个功能简直是神器！

Terminal window

1
# 分屏广播输入操作
2
1. 打开多个服务器连接
3
2. 点击「广播输入」按钮
4
3. 在任意窗口输入命令
5
4. 所有窗口同步执行！

SFTP 文件传输#

SSH 连接的同时，自动打开 SFTP 面板：

Terminal window

1
# 文件操作
2
├─ 拖拽上传/下载
3
├─ 右键菜单操作
4
├─ 权限管理(chmod)
5
└─ SUDO提权编辑

支持跨服务器文件传输，复制粘贴即可：

Terminal window

1
# 跨服务器文件传输
2
1. 在服务器A选中文件 → Ctrl+C
3
2. 在服务器B目标目录 → Ctrl+V
4
3. 自动完成传输！

数据库管理#

支持 15+ 种数据库，一个界面搞定所有：

Terminal window

1
# 数据库操作
2
├─ SQL查询编辑器（语法高亮）
3
├─ 表结构可视化编辑
4
├─ 数据内联编辑
5
├─ 数据字典导出
6
└─ XLSX导入导出

连接配置也很简单：

1
# MySQL连接配置
2
├─ 类型: MySQL
3
├─ 主机: localhost
4
├─ 端口: 3306
5
├─ 数据库: test
6
└─ 用户名/密码

Docker 管理#

可视化管理 Docker 容器和镜像：

Terminal window

1
# Docker功能
2
├─ 容器列表（状态一目了然）
3
├─ 容器终端（直接进入容器）
4
├─ 容器日志（实时查看）
5
├─ 镜像管理（拉取/删除）
6
└─ 镜像导入导出

专业版还支持 Docker-Compose 编辑：

1
# Docker-Compose 示例
2
version: '3.8'
3
services:
4
  web:
5
    image: nginx:latest
6
    ports:
7
      - "80:80"

实时面板#

一键查看服务器状态：

Terminal window

1
# 实时面板内容
2
├─ 网速监控（上传/下载）
3
├─ CPU使用率
4
├─ 内存使用率
5
├─ 进程列表
6
├─ Docker容器列表
7
└─ 磁盘挂载列表

我的使用感受#

作为一个每天要管理十几台服务器的运维工程师，我必须说 HexHub 彻底改变了我的工作方式。以前打开一堆工具窗口，找个连接要半天，现在一个 HexHub 搞定所有！

最让我惊喜的是分屏广播输入功能，以前更新配置要一台台服务器登录执行，现在一键同步，效率提升了十倍不止。还有跨服务器文件传输，再也不用先下载到本地再上传了，直接复制粘贴就搞定！

项目资源#

官网地址: https://www.hexhub.cn/

下载地址: https://www.hexhub.cn/#download

觉得工具不错的话，记得分享给你的小伙伴！

项目特色: 一站式开发运维工具，集成数据库、Docker、SSH、SFTP，支持跨平台，免费版功能齐全，专业版功能强大。

互动时间#

你是不是已经受够了在各种工具之间来回切换？赶紧试试 HexHub，体验一下一站式开发运维的快感！

如果你用了之后有什么有趣的体验，或者有什么功能建议，欢迎在评论区和我交流。我会定期分享更多好用的开发工具，记得关注我哦！

GitHub热门项目！llmfit，一键找到最适合你电脑的大模型

2026-05-06T00:00:00.000Z

前言#

嘿，小伙伴们！最近是不是经常遇到这样的困扰：想在本地跑大模型，但不知道自己的电脑能跑哪个？下载了模型才发现显存不够，或者速度慢得让人抓狂？作为一个AI爱好者，我太懂这种感受了！曾经为了找一个适合我笔记本的模型，我试遍了各种方法，浪费了大量时间下载那些根本跑不动的模型。

直到最近发现了一个宝藏项目——llmfit！这是一个专门为本地大模型爱好者打造的工具，只要一条命令，它就能自动检测你的硬件配置，评估上百个模型在你电脑上的运行情况，然后告诉你哪些模型能完美运行，哪些可以勉强运行，哪些根本跑不动。

这两天这个项目在AI圈子里特别火，今天我就来和大家唠唠这个神奇的工具，让你再也不用为选模型发愁！

项目介绍#

✨ 核心特性#

🔍 智能硬件检测: 自动识别你的 CPU、GPU、RAM 配置，支持 CUDA、Metal、ROCm 等加速后端
📊 多维度评分: 从质量、速度、适配性、上下文四个维度为每个模型打分
🚀 一键推荐: 告诉你哪些模型能完美运行，哪些可以尝试，哪些直接放弃
💬 交互式界面: 漂亮的 TUI 界面，操作直观，新手也能轻松上手
🔧 灵活模式: 支持 TUI（交互式）和 CLI（命令行）两种模式
⚡ 支持多GPU: 完美支持多GPU配置，充分利用你的硬件资源
🧠 MoE支持: 支持 Mixture-of-Experts 架构的模型评估

📊 评分维度#

维度	说明	权重
质量 (Quality)	模型本身的能力和性能	35%
速度 (Speed)	推理速度估计	25%
适配性 (Fit)	模型与硬件的匹配程度	25%
上下文 (Context)	上下文窗口大小	15%

实战体验#

安装方式#

方式一：一键安装（推荐）

Terminal window

1
# macOS/Linux 一键安装
2
curl -fsSL https://llmfit.axjns.dev/install.sh | sh

方式二：Homebrew 安装（macOS）

Terminal window

1
brew tap AlexsJones/llmfit && brew install llmfit

方式三：Cargo 安装

Terminal window

1
cargo install llmfit

启动工具#

安装完成后，直接在终端输入：

Terminal window

1
llmfit

工具会自动检测你的硬件配置，然后显示交互式界面：

查看推荐模型#

界面会显示所有支持的模型，并按照适配程度排序：

Perfect: 完美适配，推荐使用
Good: 良好适配，可以尝试
Marginal: 勉强运行，可能卡顿
Too tight: 显存不足，不建议尝试

CLI 模式#

如果你喜欢命令行方式，可以使用 --cli 参数：

Terminal window

1
# 查看所有可用模型
2
llmfit --cli
3

4
# 只显示能完美运行的模型
5
llmfit --cli --perfect
6

7
# 指定显存限制
8
llmfit --cli --memory 24G
9

10
# 输出 JSON 格式
11
llmfit --cli --json

筛选模型#

使用各种筛选参数找到最适合你的模型：

Terminal window

1
# 按使用场景筛选
2
llmfit --use-case coding    # 编码
3
llmfit --use-case reasoning # 推理
4
llmfit --use-case chat      # 聊天
5
llmfit --use-case multimodal # 多模态
6

7
# 按运行时筛选
8
llmfit --runtime llamacpp
9
llmfit --runtime mlx
10

11
# 搜索模型
12
llmfit --search "Qwen"
13
llmfit --search "7B"

API 服务模式#

llmfit 还提供了 REST API，可以集成到你的应用中：

Terminal window

1
# 启动 API 服务
2
llmfit serve --host 0.0.0.0 --port 8787

Terminal window

1
# 获取系统信息
2
curl http://localhost:8787/api/v1/system
3

4
# 获取推荐模型
5
curl http://localhost:8787/api/v1/models/top?limit=5
6

7
# 按场景筛选
8
curl "http://localhost:8787/api/v1/models?use_case=coding&min_fit=good"

我的使用感受#

作为一个经常折腾本地大模型的爱好者，我必须说这个工具彻底改变了我的体验。以前每次想换个模型试试，都要先查半天资料，下载下来才发现跑不动或者速度太慢。现在有了 llmfit，一键就能知道哪些模型适合我的配置，节省了大量时间和带宽。

最让我惊喜的是它对 MoE 模型的支持，以前我根本不敢碰那些大模型，现在有了准确的显存估算，我知道哪些 MoE 模型能在我的显卡上运行了。而且界面做得特别漂亮，交互也很流畅，用起来特别舒服！

项目资源#

GitHub地址: https://github.com/AlexsJones/llmfit

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 智能大模型硬件匹配工具，自动检测配置，多维度评分推荐，支持 TUI/CLI/API 三种模式，支持 MoE 架构和多 GPU 配置。

互动时间#

你是不是已经跃跃欲试了？赶紧安装 llmfit，看看你的电脑能跑哪些大模型吧！

如果你用了之后有什么有趣的发现，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的 AI 工具和技术教程，记得关注我哦！

GitHub宝藏项目！Motrix Next，让下载变成一种享受

2026-05-06T00:00:00.000Z

前言#

嘿，小伙伴们！不知道你们有没有遇到过这些糟心事：浏览器下载大文件，速度慢得像蜗牛不说，还动不动就断开；公司电脑配置低，用个下载工具占内存比浏览器还多；想下载个学习资料，文件名还乱码成一堆乱字符…作为一个经常下载各种资源的老网民，我太懂这种感受了！每次遇到下载问题，都恨不得把那个软件给卸载了。

直到最近发现了一个宝藏项目——Motrix Next！这是一款基于 Tauri 2 全新重写的下载工具，安装包只有 15MB，却能做 90MB 老版本做不到的事情。更轻、更快、更安全，用起来还特别顺手，简直就是下载工具中的”小钢炮”！

今天我就来和大家唠唠这个神器，看看它是怎么解决我们这些下载痛点的！

项目介绍#

✨ 核心特性#

🚀 轻量高效: 安装包仅 15MB，内存占用极低，Rust 后端保障性能
🔧 全协议支持: HTTP/FTP/BT/Magnet/Thunder，一网打尽所有下载需求
🎨 全新 UI: Material Design 3 风格，支持深色模式，界面美观大方
🌐 26种语言: 完整国际化支持，切换语言无压力
🔄 自动更新: 稳定版/测试版双通道，想尝鲜还是求稳定随你选
💾 断点续传: 告别下载中断的烦恼，从头再来不存在的

🆚 对比老版本#

特性	Motrix (老版)	Motrix Next
框架	Electron	Tauri 2 (Rust)
前端	Vue 2 + VueX	Vue 3 + Pinia
安装包大小	~90 MB	~15 MB
内存占用	较高	极低
启动速度	较慢	秒开
安全性	一般	Rust内存安全

🛠️ 技术栈#

分类	技术
框架	Tauri 2
前端	Vue 3 + TypeScript
状态管理	Pinia
UI组件	Naive UI
下载引擎	aria2
语言	Rust + TypeScript

实战体验#

下载安装#

首先，咱们去 GitHub 下载安装包：

下载地址: https://github.com/AnInsomniacy/motrix-next/releases

支持三大平台：

Windows: x64 / ARM64 (.exe)
macOS: Apple Silicon / Intel (.dmg)
Linux: x64 / ARM64 (.AppImage / .deb)

Terminal window

1
# Windows 用户双击 .exe 安装包，一路下一步即可
2

3
# macOS 用户拖拽到 Applications 文件夹
4

5
# Linux 用户
6
sudo dpkg -i MotrixNext_*.deb

界面初体验#

打开软件，第一感觉就是清爽！Material Design 3 的设计风格看起来特别舒服：

左侧是任务列表，清晰展示所有下载任务
顶部是工具栏，常用功能一目了然
右下角是速度面板，实时网速一览无余

新建下载任务#

有三种方式添加下载任务：

方式一：直接粘贴链接

1
# 复制下载链接
2
# 在 Motrix Next 中按下 Ctrl + V
3
# 自动识别并添加任务

方式二：手动输入

点击工具栏的「新建」按钮，输入下载链接和保存位置：

1
任务配置：
2
├─ URL: https://example.com/file.zip
3
├─ 保存目录: D:\Downloads
4
└─ 文件名: file.zip

方式三：BT种子和磁力链接

直接拖拽 .torrent 文件到窗口，或者粘贴磁力链接：

1
magnet:?xt=urn:btih:xxxxx...

BT下载增强功能#

Motrix Next 的 BT 功能特别强大！

GeoIP 显示: 显示每个 peer 的国家国旗，一眼看出热门资源分布：

1
Peers:
2
🇨🇳 China (12 peers)
3
🇺🇸 USA (5 peers)
4
🇯🇵 Japan (3 peers)

tracker 列表管理: 自动获取最佳 tracker，提高下载速度：

Terminal window

1
# 自动更新 tracker 列表
2
# 无需手动配置，开箱即用

速度限制与调度#

不想让下载占满带宽？没问题！

Terminal window

1
# 全局速度限制
2
# 最大上传速度: 1 MB/s
3
# 最大下载速度: 不限
4

5
# 下载调度
6
# 定时开始/停止下载任务
7
# 自动化管理你的下载任务

轻量级模式#

这就是黑科技了！开启轻量级模式后，最小化到托盘会自动销毁 WebView，减少约 150MB 内存占用：

Terminal window

1
# 开启轻量级模式
2
# 设置 → 轻量级模式 → 启用
3

4
# 效果：
5
# 内存占用减少 ~150MB
6
# 托盘操作完全正常
7
# 下载任务继续运行

保持唤醒功能#

下载大文件怕电脑睡着？开启「保持唤醒」功能：

Terminal window

1
# 开启保持唤醒
2
# 下载期间防止系统休眠
3
# 支持 macOS / Windows / Linux

浏览器集成#

配合浏览器扩展使用更方便！

Terminal window

1
# 安装 Motrix Next 浏览器扩展
2
# 支持 Chrome / Firefox / Edge
3

4
# 一键下载：
5
# 页面点击下载按钮 → 自动唤醒 Motrix Next → 开始下载

我的使用感受#

作为一个下载工具的重度用户，我必须说 Motrix Next 彻底征服了我。以前用 Electron 版的下载工具，内存占用高得吓人，开个浏览器再加下载工具，电脑就开始卡顿。现在用了 Motrix Next，16GB 内存的笔记本终于不再”喘粗气”了！

最让我惊喜的是 BT 下载的 GeoIP 功能，以前不知道哪些peer是国内的，现在一眼就能看出来，下载热门资源的时候心里更有底了。还有那个轻量级模式，之前根本不敢边下载边做其他事，现在开着一堆任务，电脑照样流畅跑游戏！

项目资源#

GitHub地址: https://github.com/AnInsomniacy/motrix-next 官网地址: https://motrix-next.pages.dev/

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 基于 Tauri 2 全新重写的下载工具，支持全协议下载，15MB 安装包 + Rust 后端保障，内存占用极低，支持 26 种语言和深色模式。

互动时间#

你是不是已经受够了那些卡顿、占地儿、还经常断流的下载工具？赶紧试试 Motrix Next，体验一下什么叫”轻盈下载”！

如果你用了之后有什么有趣的体验，或者下载过程中遇到什么问题，欢迎在评论区和我交流。我会定期分享更多好用的效率工具，记得关注我哦！

GitHub宝藏项目！TREK，五一出游必备的智能旅行规划神器

2026-04-30T00:00:00.000Z

前言#

嘿，小伙伴们！五一假期马上就要到了，是不是已经按捺不住想要出去玩的心情了？作为一个爱旅行的”驴友”，每次出行前最头疼的就是做攻略——景点太多不知道怎么安排、路线规划太复杂、预算总是超支…相信很多朋友都有同感吧？

直到最近发现了一个宝藏项目——TREK！这是一个开源的自托管旅行规划工具，简直就是为我们这些爱旅行的人量身打造的。有了它，旅行规划变得超级简单：实时协作让团队旅行更高效，交互式地图让路线规划一目了然，预算追踪帮你控制开支，打包清单再也不会丢三落四。

项目介绍#

✨ 核心特性#

🧭 智能行程规划: 拖拽式规划器，轻松安排每天的行程，支持跨天调整和重新排序
🗺️ 交互式地图: 支持 Leaflet 或 Mapbox GL，带3D建筑、地形、照片标记和路线可视化
🔍 地点搜索: 支持 Google Places 和 OpenStreetMap，找景点、餐厅、住宿超方便
📝 每日笔记: 带时间戳和图标的笔记功能，记录旅行点滴
🚗 路线优化: 自动排序地点，支持导出到 Google Maps
🌤️ 天气预报: 16天天气预报，提前做好出行准备
💰 预算追踪: 分类支出管理，支持多人分摊和多币种
🧳 打包清单: 分类模板、成员分配、进度追踪，再也不会漏东西

👥 团队协作功能#

🔄 实时同步: WebSocket 实时同步，修改即时显示
👨‍👩‍👧‍👦 多用户协作: 支持多人共享行程，角色权限管理
📧 邀请链接: 一次性或可重复使用的邀请链接，带有效期
🔐 SSO 登录: 支持 Google、Apple、Authentik、Keycloak 等多种登录方式
💬 团队聊天: 群组聊天、共享笔记、投票、每日签到

📱 移动体验#

📲 PWA 支持: iOS 和 Android 都能安装，无需应用商店
📴 离线支持: 离线缓存地图和数据，旅途中随时查看
🎨 原生体验: 全屏独立运行，主题状态栏，启动画面

实战体验#

快速开始#

TREK 支持多种部署方式，最简单的就是用 Docker：

Terminal window

1
# 生成加密密钥
2
ENCRYPTION_KEY=$(openssl rand -hex 32)
3

4
# 启动容器
5
docker run -d -p 3000:3000 \
6
  -e ENCRYPTION_KEY=$ENCRYPTION_KEY \
7
  -v ./data:/app/data -v ./uploads:/app/uploads mauriceboe/trek

Docker Compose 部署

1
services:
2
  app:
3
    image: mauriceboe/trek:latest
4
    container_name: trek
5
    read_only: true
6
    security_opt:
7
      - no-new-privileges:true
8
    cap_drop:
9
      - ALL
10
    cap_add:
11
      - CHOWN
12
      - SETUID
13
      - SETGID
14
    tmpfs:
15
      - /tmp:noexec,nosuid,size=64m
16
    ports:
17
      - "3000:3000"
18
    environment:
19
      - NODE_ENV=production
20
      - PORT=3000
21
      - ENCRYPTION_KEY=${ENCRYPTION_KEY:-}   # generate with: openssl rand -hex 32
22
      - TZ=${TZ:-UTC}
23
      - LOG_LEVEL=${LOG_LEVEL:-info}
24
      - ALLOWED_ORIGINS=${ALLOWED_ORIGINS:-}
25
      - APP_URL=${APP_URL:-}                 # required for OIDC + email links
26
      # - FORCE_HTTPS=true                   # behind a TLS-terminating proxy
27
      # - TRUST_PROXY=1
28
      # - OIDC_ISSUER=https://auth.example.com
29
      # - OIDC_CLIENT_ID=trek
30
      # - OIDC_CLIENT_SECRET=supersecret
31
      # - OIDC_DISPLAY_NAME=SSO
32
      # - OIDC_ADMIN_CLAIM=groups
33
      # - OIDC_ADMIN_VALUE=app-trek-admins
34
    volumes:
35
      - ./data:/app/data
36
      - ./uploads:/app/uploads
37
    restart: unless-stopped
38
    healthcheck:
39
      test: ["CMD", "wget", "-qO-", "http://localhost:3000/api/health"]
40
      interval: 30s
41
      timeout: 10s
42
      retries: 3
43
      start_period: 15s

展开收起

打开浏览器访问 http://localhost:3000 即可使用！

提示：首次登录时，需要从docker log 中获取默认账号密码 docker logs trak。

Terminal window

1
[DB] Running migration 125/125[DB] Migrations complete - schema version 125
2
TREK - First Run: Admin Account Created
3
Email:  admin@trek.local
4
Password:  XXXXXidJ4HS1

创建旅行计划#

登录后，点击”新建行程”开始规划你的五一之旅：

设置基本信息: 输入行程名称、目的地、日期范围
添加成员: 邀请家人或朋友一起协作规划
规划每日行程: 拖拽地点到每一天的计划中

搜索地点#

使用地点搜索功能查找景点、餐厅、酒店：

1
# 搜索示例
2
搜索 "北京故宫" → 查看评分、照片、营业时间 → 添加到行程

支持 Google Places 和 OpenStreetMap 两种数据源，后者完全免费无需 API 密钥。

查看地图#

交互式地图让你的行程一目了然：

查看所有计划地点的位置分布
可视化路线规划
3D 建筑和地形视图
照片标记展示

管理预订#

记录航班、住宿、餐厅等预订信息：

类型	信息
航班	航空公司、航班号、确认号
住宿	酒店名称、地址、入住时间
餐厅	名称、时间、人数

预算追踪#

设置旅行预算，实时追踪支出：

1
# 预算设置流程
2
设置总预算 → 分类添加支出 → 查看饼图统计 → 多人分摊计算

支持多币种和按人/按天拆分，帮你管好旅行经费。

打包清单#

创建打包清单，确保出行前万事俱备：

1
# 打包清单示例
2
衣物: 上衣×3, 裤子×2, 外套×1
3
洗漱用品: 牙刷, 牙膏, 毛巾
4
电子产品: 手机, 充电器, 相机

支持模板、成员分配和进度追踪。

团队协作#

和朋友一起规划行程：

发送邀请链接
实时看到对方的修改
群聊讨论行程细节
投票决定去哪玩

项目资源#

GitHub地址: https://github.com/mauriceboe/TREK 体验地址: https://demo-nomad.pakulat.org/

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 自托管的旅行规划工具，支持实时协作、交互式地图、预算管理、打包清单、PWA 离线使用，适合家庭旅行和团队出游。

互动时间#

五一假期就要来了，你是不是已经跃跃欲试了？赶紧用 TREK 规划你的完美假期吧！

如果你用了之后有什么有趣的体验，或者有什么旅行规划的好建议，欢迎在评论区和我交流。我会定期分享更多好用的工具和旅行攻略，记得关注我哦！祝大家五一假期玩得开心！🎉

GitHub热门项目！Cloud Mail，用Cloudflare免费搭建个人邮件服务

2026-04-29T00:00:00.000Z

前言#

嘿，小伙伴们！最近是不是经常遇到这样的困扰：想拥有一个专属的个人邮箱服务，但是传统的邮箱方案要么太贵，要么配置太复杂？作为一个爱折腾的开发者，我太懂这种感受了！曾经为了搭建一个简单的邮件服务，我研究了各种方案，最后要么因为成本太高放弃，要么因为配置繁琐半途而废。

直到最近发现了一个宝藏项目——Cloud Mail！这是一个专门为 Cloudflare Workers 设计的轻量级邮件服务，让我们可以用几乎零成本搭建自己的邮件系统。不用买服务器，不用配置复杂的环境，只要一个域名和 Cloudflare 账号，就能拥有属于自己的邮件服务。

这两天这个项目在开发者圈子里特别火，今天我就来手把手教大家怎么用 Cloudflare 部署这个项目，体验一下免费搭建邮件服务的快乐！

项目介绍#

✨ 核心特性#

🚀 零成本部署: 基于 Cloudflare Workers，免费额度完全够用，个人使用几乎零成本
🎯 多域名支持: 支持多个域名创建不同的邮箱地址，一套系统满足多种需求
💰 无限邮箱: 理论上可以创建无限个邮箱账号，告别邮箱数量限制
🔧 简单配置: 通过环境变量和 Web 界面即可完成配置，无需复杂命令
📦 开源免费: 完全开源，代码透明，社区活跃，更新频繁

🎯 应用场景#

个人邮箱: 搭建专属的个人邮箱服务，告别商业邮箱的广告和限制
团队协作: 为小团队创建统一的邮箱系统，提升专业形象
项目邮箱: 为开源项目或个人项目创建专门的联系邮箱
隐私保护: 避免使用第三方邮箱泄露个人信息

部署实战#

环境准备#

首先，我们需要准备一个 Cloudflare 账号和一个已经接入 Cloudflare 的域名。如果你还没有域名，可以在 Cloudflare Registrar 购买一个，非常便宜。

项目下载#

首先，咱们去 GitHub 把项目克隆到自己的账号：

创建 Worker 项目#

现在我们来创建 Cloudflare Worker 项目：

登录 Cloudflare 控制台，进入 Workers & Pages
点击 创建应用 → Pages → 连接到 Git
选择刚才 fork 的仓库,并设置目录为 mail-worker

设置环境变量#

部署成功后，进入项目设置页面，添加以下环境变量：

变量名	必填	用途	示例
`domain`	✅	邮箱域名，多个域名用数组	`["example.com"]`
`admin`	✅	管理员邮箱地址	`admin@example.com`
`jwt_secret`	✅	JWT 密钥，随机字符串	`your-secret-key-123`
`project_link`	❌	是否显示项目链接	`true` 或 `false`

添加环境变量的界面：

绑定数据库#

接下来需要创建并绑定数据库：

创建 KV 命名空间#

进入 Workers & Pages → KV → 创建命名空间
命名为 cloud-mail-kv

创建 D1 数据库#

进入 Workers & Pages → D1 → 创建数据库
命名为 cloud-mail-db

绑定到 Worker#

进入项目设置 → 环境变量 → 绑定
添加 KV 绑定：
- 变量名：kv（必须是这个名字）
- 选择刚才创建的 KV 命名空间
添加 D1 绑定：
- 变量名：db（必须是这个名字）
- 选择刚才创建的 D1 数据库

设置自定义域名#

为了让邮箱服务可以通过自定义域名访问，我们需要添加自定义域名：

进入项目设置 → 自定义域 → 添加自定义域
输入你的域名，比如 mail.example.com
按照提示添加 DNS 记录

设置转发#

进入域管理
设置电子邮件路由

初始化数据库#

现在我们需要初始化数据库，在浏览器中访问：

1
https://你的自定义域名/api/init/你的jwt_secret

替换成你自己的域名和 jwt_secret，访问后会看到成功提示：

注册管理员账号#

打开浏览器访问你的自定义域名，会看到注册页面：

输入管理员邮箱（必须和环境变量中的 admin 一致）
设置密码
点击注册

登录系统#

注册成功后，使用管理员账号登录：

添加邮箱用户#

登录后，可以在管理界面添加邮箱用户：

点击左侧菜单的 用户管理
点击 添加用户
输入邮箱地址和密码（密码可不填，会自动生成）

测试发送邮件#

添加用户后，我们可以测试发送邮件功能：

登录用户邮箱
点击 写邮件
输入收件人、主题和内容
点击发送

总结#

今天主要带大家了解并实现了 Cloud Mail 的完整部署流程，该邮件服务以 “Cloudflare Workers + Hono” 为核心优势，结合个人邮箱需求，通过 Cloudflare 平台与 D1/KV 数据库，形成了一套从域名准备到邮件收发的全链路解决方案。通过这套实践方案，个人开发者能够高效突破传统邮箱服务的成本瓶颈——借助环境配置、数据库绑定、自定义域设置等操作（包括创建 Worker、配置环境变量、绑定 KV/D1、初始化数据库、注册账号），无需购买服务器或配置复杂环境，就能快速搭建专属邮件服务（如本次演示的 “个人邮箱系统”）。无论是多域名支持、无限邮箱创建，还是邮件收发、用户管理，都能通过简单的 Web 界面完成，极大降低了个人邮件服务的搭建门槛。在实际应用中，该服务不仅零成本运行，还具备良好的扩展性，适配性远优于传统的自建邮件服务器方案；特别是通过 Cloudflare 的全球 CDN 加速，有效解决了邮件传输延迟的难题。同时，方案具备良好的扩展性——小伙伴们可以基于此扩展更多应用场景，如团队协作邮箱、项目联系邮箱、隐私保护邮箱等，进一步发挥 Cloud Mail 在个人服务、团队协作、开源项目等领域的应用价值。感兴趣的小伙伴可以按照文中提供的步骤进行实践，根据实际需求类型调整域名配置和用户权限。今天的分享就到这里结束了，我们下一篇文章见。

项目资源#

GitHub地址: https://github.com/maillab/cloud-mail

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 基于 Cloudflare Workers 的轻量级邮件服务，支持多域名、无限邮箱账号，零成本搭建个人邮件系统。

互动时间#

你是不是已经跃跃欲试了？赶紧去 GitHub fork 这个项目，试试用 Cloudflare 免费搭建自己的邮件服务吧！

如果你在部署过程中遇到什么问题，或者有什么有趣的体验，欢迎在评论区和我交流。我会定期分享更多好用的开发工具和技术教程，记得关注我哦！

（注：文章部分信息来源于 cloud-mail 官网）

GitHub宝藏项目！LocalSqueeze，让图片压缩既安全又高效

2026-04-29T00:00:00.000Z

前言#

嘿，小伙伴们！最近是不是经常遇到这样的困扰：想压缩图片但又担心隐私泄露？用在线工具吧，怕图片上传到服务器被窃取；用付费软件吧，又觉得不值当。作为一个经常需要处理图片的开发者，我太懂这种感受了！曾经为了压缩一张图片，我试遍了各种在线工具，每次上传都提心吊胆的，总担心图片里的敏感信息被泄露。

直到最近发现了一个宝藏项目——LocalSqueeze！这是一款完全在本地运行的图片压缩工具，所有操作都在你的电脑上完成，零数据泄露风险。压缩效果还超级棒，实测比 TinyPNG 压缩得更小，质量还没差异。

这两天这个项目在开发者圈子里特别火，今天我就来和大家唠唠这个神奇的工具，看看它是怎么让图片压缩变得既安全又高效的。

项目介绍#

✨ 核心特性#

🔐 安全至上: 所有操作均在本地完成，零数据泄露风险，隐私安全有保障
🔍 高质量压缩: 智能压缩策略，在保持图片质量的同时最大程度减小文件大小
🚀 批量处理: 同时处理多张图片，大大提高工作效率
🎨 体验优先: 直观的界面设计，流畅的操作体验，新手也能轻松上手
🔧 灵活配置: 丰富的压缩参数，满足专业用户的个性化需求
🌍 跨平台: 支持 Windows、macOS 主流平台，无论用什么系统都能用
👁️ 效果对比: 直观对比压缩前后的效果，确保图片质量符合预期
🌓 深色模式: 支持深色/浅色主题切换，保护你的眼睛

🆚 与同类产品对比#

特性	LocalSqueeze	TinyPNG	Picdiet
隐私安全	100% 本地处理	需上传服务器	需上传服务器
压缩效果	更优（104KB vs 175KB）	一般	一般
网络依赖	无需网络	需要网络	需要网络
费用	完全免费	有限免费	有限免费
配置选项	丰富	简单	简单
支持格式	多种	仅支持 JPG/PNG	仅支持 JPG

实战体验#

环境准备#

用这个工具真的超级简单，不需要任何特殊环境，只要你的电脑能运行普通软件就行。支持 Windows 10+ 和 macOS 10.14+，几乎覆盖了所有主流系统。

下载安装#

首先，咱们去 GitHub 看看这个宝藏仓库：https://github.com/freeany/LocalSqueeze

在 Release 页面下载对应系统的安装包：

Windows 用户: 下载 .exe 安装文件
macOS 用户: 下载 .dmg 磁盘镜像

下载完成后，双击安装包进行安装，一路点击下一步即可。

启动应用#

安装完成后，在应用列表找到 LocalSqueeze 并启动：

界面非常简洁，主要分为几个区域：

顶部工具栏: 包含压缩级别选择、输出格式选择等
中间预览区: 显示正在处理的图片
底部状态栏: 显示压缩进度和结果

选择压缩级别#

LocalSqueeze 提供了多种压缩级别供选择：

级别	压缩率	质量	适用场景
最低	约 30%	最高	对质量要求极高的场景
低	约 50%	高	一般图片处理
中	约 65%	中高	网页图片
高	约 80%	中等	社交媒体图片
最高	约 90%	较低	对质量要求不高的场景

根据你的需求选择合适的压缩级别，默认是 “中” 级别，适合大多数场景。

添加图片#

有两种方式可以添加图片：

方式一：拖拽添加 直接将图片或包含图片的文件夹拖拽到应用窗口中：

1
# 拖拽操作
2
# 从文件夹中选中图片 → 拖拽到 LocalSqueeze 窗口

方式二：点击添加 点击窗口中的 “添加图片” 按钮，选择要压缩的图片：

1
# 点击操作流程
2
# 点击「添加图片」→ 选择图片文件 → 确认添加

开始压缩#

添加完图片后，点击 “开始压缩” 按钮：

1
# 压缩命令（软件内部执行）
2
# 点击「开始压缩」→ 等待处理 → 完成

压缩过程中会显示进度条和实时状态：

导出压缩后的图片#

点击 “导出全部” 按钮，选择保存位置即可：

1
# 导出操作
2
# 点击「导出全部」→ 选择保存目录 → 确认导出

导出后的图片会自动保存在你选择的目录中，文件名保持不变。

我的使用感受#

作为一个经常需要处理大量图片的开发者，我必须说这个工具彻底改变了我的工作流程。以前压缩图片，我总是小心翼翼地选择在线工具，每次都要检查图片里有没有敏感信息。现在有了 LocalSqueeze，我再也不用担心了，所有操作都在本地完成，安全感爆棚！

前几天我用它压缩了一批产品图片，520KB 的图片压缩后只有 104KB，节省了 80% 的空间，而且质量几乎看不出差别。最让我惊喜的是批量处理功能，一次性拖入几十张图片，几分钟就全部搞定了，效率提升了不止十倍！

项目资源#

GitHub地址: https://github.com/freeany/LocalSqueeze

觉得项目不错的话，记得给作者点个 star 支持一下！

项目特色: 完全本地运行的图片压缩工具，安全高效，支持批量处理和效果对比，跨平台支持，完全免费开源。

互动时间#

你是不是已经跃跃欲试了？赶紧去 GitHub 下载这个神器，试试用它压缩你的图片吧！

如果你用了之后有什么有趣的体验，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的开发工具，记得关注我哦！

无需服务器！使用Cloudflare免费部署Sink短链接工具

2026-04-27T00:00:00.000Z

前言#

嘿,小伙伴们!在日常工作和生活中,你是不是经常遇到需要分享长链接的场景?比如分享一个复杂的URL,不仅看起来冗长难记,而且在某些平台上还可能被自动截断,影响用户体验。这时候,一个好用的短链接工具就显得尤为重要了。

今天我要给大家介绍一款开源、高效、安全的短链接工具——Sink。它的最大特点是完全运行在Cloudflare上,无需传统服务器,可以免费部署和使用。而且它还支持自定义别名、AI Slug生成、链接分析等强大功能,简直是短链接工具中的佼佼者!

这两天这个项目在开发者圈子里特别火,今天我就来和大家唠唠如何在Cloudflare上免费部署和使用Sink,让你的链接分享变得更加简洁高效。

项目介绍#

✨ 核心特性#

🚀 URL缩短: 将冗长的网址压缩到最短长度，方便分享和记忆
📊 链接分析: 监控链接点击数据，收集有洞察力的统计信息
☁️ 无服务器部署: 完全运行在Cloudflare上，无需传统服务器
🎨 自定义别名: 支持创建个性化的短链接别名
🤖 AI Slug: 利用AI自动生成有意义的短链接Slug
⏰ 链接过期: 为短链接设置过期日期，增强安全性
🔒 安全可靠: 开源免费，无广告，数据安全可控

🛠️ 技术栈#

类别	技术	说明
前端	React	现代化的前端框架，提供流畅的用户界面
后端	Cloudflare Workers	无服务器计算平台，提供高效的后端服务
存储	Cloudflare KV	键值存储服务，用于存储短链接数据
分析	Cloudflare Analytics Engine	提供链接点击分析功能
部署	Cloudflare Pages	静态网站托管服务，用于部署前端应用

🎯 应用场景#

社交媒体分享: 缩短长链接，提升分享体验
营销活动: 追踪链接点击数据，分析用户行为
企业内部: 统一管理内部链接，方便员工访问
个人使用: 整理和管理个人常用链接

部署教程#

环境准备#

部署Sink只需要一个Cloudflare账号，不需要任何服务器或其他基础设施。如果还没有Cloudflare账号，可以免费注册一个。

步骤1: Fork Sink项目#

访问Sink项目的GitHub页面
点击页面右上角的”Fork”按钮
在弹出的对话框中，选择你要将项目fork到的GitHub账户
等待fork完成，你会被重定向到你自己账户下的Sink项目页面

步骤2: 登录Cloudflare账号#

访问Cloudflare官网并登录你的账号。

步骤3: 创建KV命名空间#

在Cloudflare控制台中，点击左侧菜单的”存储和数据库”，点击“workers KV”
点击右上角的“Create Instance”，创建一个新的KV命名空间
点击”创建命名空间”按钮
输入命名空间名称为”sink”，然后点击”创建”

步骤4: 创建Pages项目#

回到”Workers & Pages”页面
点击”想要部署 Pages？开始使用”
点击”导入现有 Git 存储库-开始使用”按钮
选择”连接到Git”
选择你的Git提供商（GitHub、GitLab或Bitbucket）
授权Cloudflare访问你的Git账户
在仓库列表中找到并选择你自己账户下的”Sink”仓库（不是miantiao-me/Sink）
配置环境变量
- NUXT_SITE_TOKEN：必须至少8个字符。此令牌授予访问仪表盘的权限。
- NUXT_CF_ACCOUNT_ID：找到你的账户ID。（域名—>概览—>点击你的域名）
- NUXT_CF_API_TOKEN：创建一个至少获得权限的 Cloudflare API 令牌。（点击创建令牌 → 创建自定义令牌 → 自己取个名称，权限这里要选择账户/账户分析/读取。）
点击”保存并部署”

步骤5: 部署项目#

点击”保存并部署”按钮
等待部署完成，这可能需要几分钟时间，部署可能会失败，报下面这个错误

1
15:14:23.224  Success: Assets published!
2
15:14:24.029  Error: Failed to publish your Function. Got error: Uncaught Error: No such module "node:buffer".
3
  imported from "bundledWorker-0.2566199779193783.mjs"

设置下node兼容性标志，然后重新部署，就不会报错了
首次部署成功后,你会看到部署成功的消息和临时域名,这个时候还需要设置下KV，你需要进入项目的 “Settings” 页面，导航至 “Functions” -> “Bindings“，在设置中绑定选择kv命名空间，找到我们刚才创建好的kv命名空间，变量名称选择KV（必须是大写的KV）
重新部署项目,这一次，部署将包含你新配置的绑定和标志。

步骤6: 配置自定义域名#

在Pages项目页面，点击”自定义域”
点击”添加自定义域”
输入你想要使用的域名，然后点击”继续”
按照提示在你的域名注册商处添加DNS记录
等待DNS记录生效，通常需要几分钟到几小时

使用指南#

生成短链接#

访问Sink管理界面：打开你部署的Sink网站
输入长链接：在输入框中粘贴你想要缩短的长链接
自定义别名（可选）：在”Custom Slug”字段中输入你想要的自定义别名
设置过期时间（可选）：选择链接的过期日期
点击生成：点击”Generate”按钮生成短链接

管理短链接#

访问管理页面：在Sink管理界面中，点击”Links”选项
编辑短链接：可以修改短链接的目标URL、过期时间等信息
删除短链接：可以删除不再需要的短链接
搜索短链接：可以通过关键词搜索已创建的短链接

我的使用感受#

作为一个经常需要分享链接的内容创作者,我必须说Sink彻底改变了我的链接分享方式。以前我使用其他短链接服务时,要么功能有限,要么需要付费,要么担心数据安全。现在有了Sink,不仅所有功能都免费,而且完全掌控在自己手中,让我使用得更加安心。

还有它的链接分析功能,让我可以清晰地看到每个链接的点击情况,这对于我分析内容效果非常有帮助。而且所有这些功能都运行在Cloudflare上,无需自己维护服务器,节省了大量的时间和精力。

前几天我用它为我的公众号文章生成了几个短链接,不仅看起来简洁美观,而且点击数据一目了然。哈哈,现在我已经彻底离不开它了!

总结#

今天和大家分享了Sink这个宝藏项目,它是一款开源、高效、安全的短链接工具,完全运行在Cloudflare上,无需传统服务器。通过简单的部署步骤,我们可以拥有一个功能强大的短链接服务,支持自定义别名、AI Slug生成、链接分析等功能。

与其他短链接服务相比,Sink最大的优势在于它的免费性和可控性。我们可以完全掌控自己的数据,而且不需要支付任何费用。无论是个人使用还是企业应用,Sink都能为我们提供稳定、高效的短链接服务。

最重要的是,作为一个开源项目,它欢迎社区贡献,这意味着它会不断进化和改进,未来会变得更加优秀。如果你正在寻找一款可靠的短链接工具,那么Sink绝对值得一试!

项目资源#

GitHub地址: https://github.com/miantiao-me/Sink demo: https://sink.cool/

觉得项目不错的话,记得给作者点个star支持一下!

项目特色: 开源免费的短链接工具,支持URL缩短、自定义别名、AI Slug生成、链接分析等功能,完全运行在Cloudflare上,无需传统服务器。

互动时间#

你是不是已经跃跃欲试了?赶紧按照文中的步骤部署一个属于自己的Sink短链接服务吧!

如果你在部署或使用过程中遇到任何问题,或者有什么有趣的使用体验,欢迎在评论区和我交流。我会定期分享更多好用的工具和教程,记得关注我哦!

今天的分享就到这里结束了,我们下一篇文章见。

GitHub宝藏项目！ZTools，开源免费的效率工具神器

2026-04-24T00:00:00.000Z

前言#

嘿,小伙伴们!作为一个每天都要和电脑打交道的打工人,你是不是经常为找应用、管理剪贴板、处理文件这些琐碎的事情感到头疼?尤其是当你需要在多个窗口之间来回切换,或者频繁重复一些操作时,是不是特别希望有个工具能帮你搞定这些?

说到效率工具,大家可能首先想到的是uTools,这款工具确实好用,但它的一些限制和收费策略也让不少用户望而却步。不过别担心,今天我要给大家介绍一个宝藏项目——ZTools,它不仅功能强大,而且完全开源免费,简直是效率工具界的一股清流!

这两天这个项目在开发者圈子里特别火,今天我就来和大家唠唠这个神奇的工具,看看它是怎么让我们的工作效率飙升的,以及为什么它比uTools更值得推荐。

项目介绍#

✨ 核心特性#

🚀 快速启动: 支持拼音搜索、正则匹配、历史记录追踪、常用应用固定，通过快捷键（macOS为Option+Z，Windows为Alt+Z）快速唤起，无需手动查找应用
🧩 插件系统: 支持UI插件和无界面插件，搭配完整API支持，既能实现可视化交互功能，也能完成后台数据处理、自动化任务
📋 剪贴板管理: 历史记录追踪、搜索功能、图片支持，跨平台原生实现，让你再也不用担心复制内容丢失
🎨 主题定制: 支持系统/浅色/深色主题，可自定义界面风格，满足不同用户的审美需求
🔒 安全可靠: 开源免费，无广告，无隐私收集，让你使用得安心
🌐 跨平台支持: 同时支持Windows和macOS，保持一致的使用体验,最新版还支持了linux

🛠️ 技术栈#

类别	技术	说明
前端	React	现代化的前端框架，提供流畅的用户界面
后端	Node.js	高效的服务器端运行环境
构建工具	Vite	快速的前端构建工具
跨平台	Electron	实现跨平台桌面应用

🎯 应用场景#

日常办公: 快速启动应用、管理剪贴板、批量处理文件
开发工作: 代码片段管理、API测试、快速搜索文档
设计工作: 颜色取色、图片处理、屏幕截图
生活助手: 天气查询、单位转换、翻译工具

实战体验#

环境准备#

用ZTools真的超级简单,不需要任何特殊环境,只要你的电脑是Windows或macOS系统就行。

项目下载#

首先,咱们去GitHub看看这个宝藏仓库:

Terminal window

1
# 克隆仓库
2
git clone https://github.com/ZToolsCenter/ZTools.git
3

4
# 或者直接下载发布版本
5
# 访问 https://github.com/ZToolsCenter/ZTools/releases

安装与配置#

下载安装包: 访问GitHub releases页面，下载对应系统的安装包
安装应用: 双击安装包，按照提示完成安装
启动应用: 安装完成后，使用快捷键Alt+Z（Windows）或Option+Z（macOS）唤起ZTools
基本设置: 首次启动时，会引导你进行基本设置，包括主题选择、快捷键设置等

使用体验#

快速启动应用#

按下快捷键Alt+Z，输入应用名称的拼音或部分文字，ZTools会智能匹配并显示结果，按回车即可启动应用。

插件使用#

ZTools内置了丰富的插件，包括文件重命名、垃圾清理、图片处理等。你还可以在插件市场中下载更多插件。

主题定制#

ZTools支持多种主题，你可以根据自己的喜好选择系统、浅色或深色主题。

ZTools vs uTools 对比#

特性	ZTools	uTools
开源状态	完全开源	闭源
价格	免费	部分功能收费
广告	无	无
插件系统	支持，API完整	支持，API完整
跨平台	Windows/macOS	Windows/macOS
剪贴板管理	原生实现，功能丰富	功能丰富
主题定制	支持多主题	支持多主题
隐私保护	开源透明	闭源，存在隐私顾虑

我的使用感受#

作为一个效率工具爱好者,我必须说ZTools彻底改变了我的工作方式。以前我使用uTools时,虽然功能不错,但总感觉有些限制,尤其是一些高级功能需要付费才能使用。现在有了ZTools,不仅所有功能都免费,而且开源透明,让我使用得更加安心。

最让我惊喜的是它的剪贴板管理功能,以前我经常因为复制了新内容而丢失之前的内容,现在有了ZTools,所有复制过的内容都能轻松找到。还有它的快速启动功能,让我再也不用在桌面和开始菜单中找应用了,按下Alt+Z,输入几个字母就能启动想要的应用,简直不要太方便!

前几天我用它的批量重命名功能处理了几百个文件,几分钟就搞定了,要是以前手动重命名,估计得花上大半天时间。哈哈,现在我已经彻底离不开它了!

总结#

今天和大家分享了ZTools这个宝藏项目,它是一款开源免费的跨平台应用启动器和插件平台,完美解决了我们日常工作中的效率问题。通过简单的快捷键操作,我们可以快速启动应用、管理剪贴板、处理文件等,极大地提升了工作效率。

与uTools相比,ZTools最大的优势在于它完全开源免费,没有任何功能限制,同时保持了与uTools相当的功能体验。无论是日常办公、开发工作还是设计工作,ZTools都能为你提供强大的支持。

最重要的是,作为一个开源项目,它欢迎社区贡献,这意味着它会不断进化和改进,未来会变得更加优秀。如果你正在寻找一款高效、免费、可靠的效率工具,那么ZTools绝对值得一试!

项目资源#

GitHub地址: https://github.com/ZToolsCenter/ZTools

觉得项目不错的话,记得给作者点个star支持一下!

项目特色: 开源免费的跨平台应用启动器和插件平台,支持快速启动、剪贴板管理、插件扩展等功能,是uTools的完美替代品。

互动时间#

你是不是已经跃跃欲试了?赶紧去GitHub下载ZTools,体验一下这个神奇的效率工具吧!

如果你用了之后有什么有趣的体验,或者有什么问题,欢迎在评论区和我交流。我会定期分享更多好用的开发工具和效率技巧,记得关注我哦!

今天的分享就到这里结束了,我们下一篇文章见。

Umami 自托管部署完整指南：Vercel + Supabase 免费方案

2026-04-22T20:31:13.000Z

什么是 Umami？#

Umami 是一个开源、轻量、隐私友好的网站分析工具，相比 Google Analytics，它更注重用户隐私，数据完全由自己掌控，而且界面简洁美观，功能实用。

为什么选择 Vercel + Supabase？#

Vercel：提供免费的静态网站托管服务，部署简单，全球 CDN，访问速度快
Supabase：提供免费的 PostgreSQL 数据库服务，适合小型应用，操作简单
完全免费：两者的免费额度足够个人和小型网站使用
无需服务器：不需要购买和维护服务器，节省成本和精力

准备工作#

1. 注册账号#

GitHub 账号：用于代码托管和 Vercel 登录
Vercel 账号：用于部署 Umami
Supabase 账号：用于提供 PostgreSQL 数据库

2. 技术要求#

基本的 Git 操作知识
基本的数据库操作知识
能够访问 GitHub、Vercel 和 Supabase 网站

步骤一：创建 Supabase 项目#

1. 登录 Supabase#

访问 Supabase 控制台，使用 GitHub 账号登录。

2. 创建新项目#

点击「New Project」按钮
填写项目信息：
- Project Name：填写项目名称，比如 umami-db
- Database Password：设置一个安全的数据库密码（记住这个密码，后面会用到）
- Region：选择离你最近的区域
点击「Create Project」按钮，等待项目创建完成（约需 2-3 分钟）

3. 获取数据库连接信息#

项目创建完成后：

点击顶部菜单的「Connect」
在「Connection String」部分，找到「URI」格式的连接字符串
复制这个连接字符串，备用

注意：连接字符串格式类似：

1
postgresql://postgres:你的密码@aws-0-us-east-1.pooler.supabase.com:6543/postgres

4. 执行数据库初始化脚本#

点击左侧菜单的「SQL Editor」
点击「New query」按钮
复制粘贴以下 SQL 脚本：

1
-- Create tables
2
CREATE TABLE IF NOT EXISTS accounts (
3
  id serial PRIMARY KEY,
4
  username VARCHAR(255) UNIQUE NOT NULL,
5
  password VARCHAR(255) NOT NULL,
6
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
7
);
8

9
CREATE TABLE IF NOT EXISTS websites (
10
  id serial PRIMARY KEY,
11
  name VARCHAR(255) NOT NULL,
12
  domain VARCHAR(255) NOT NULL,
13
  share_id VARCHAR(64) UNIQUE,
14
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
15
);
16

17
CREATE TABLE IF NOT EXISTS website_events (
18
  id serial PRIMARY KEY,
19
  website_id INTEGER NOT NULL,
20
  session_id VARCHAR(64) NOT NULL,
21
  event_type VARCHAR(64) NOT NULL,
22
  url VARCHAR(2048) NOT NULL,
23
  referrer VARCHAR(2048),
24
  device VARCHAR(64),
25
  browser VARCHAR(64),
26
  os VARCHAR(64),
27
  country VARCHAR(2),
28
  city VARCHAR(255),
29
  screen VARCHAR(64),
30
  language VARCHAR(64),
31
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
32
);
33

34
-- Create indexes
35
CREATE INDEX IF NOT EXISTS website_events_website_id_idx ON website_events(website_id);
36
CREATE INDEX IF NOT EXISTS website_events_session_id_idx ON website_events(session_id);
37
CREATE INDEX IF NOT EXISTS website_events_created_at_idx ON website_events(created_at);
38

39
-- Insert default account
40
INSERT INTO accounts (username, password) VALUES ('admin', '$2b$10$t3q4bN3BjV8sS6XZ7Y8Z9u.7a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t');

展开收起

点击「Run」按钮执行脚本

说明：默认账号的用户名是 admin，密码是 umami，登录后可以修改。

方案二：使用 Vercel Database（Neon）部署#

如果你觉得 Supabase 配置步骤太麻烦，也可以选择使用 Vercel 自带的 Neon 数据库服务，操作更加简单一体化。

1. 登录 Vercel#

访问 Vercel 控制台，使用 GitHub 账号登录。

2. 创建数据库#

在 Vercel 控制台中，点击左侧菜单的「Storage」
点击「Create Database」按钮
选择「Neon」作为数据库类型
填写数据库信息：
- Database Name：填写数据库名称，比如 umami-db
- Region：选择离你最近的区域
点击「Create」按钮，等待数据库创建完成

3. 获取数据库连接信息#

数据库创建完成后：

在 Storage 页面中，点击你刚刚创建的数据库
在「Connection Project」选项卡中，选择部署好的项目（前提是你已经部署了项目，建议先执行步骤二的内容）
重新执行步骤二的第6点内容

步骤二：部署 Umami 到 Vercel#

1. Fork Umami 仓库#

访问 Umami GitHub 仓库
点击右上角的「Fork」按钮，将仓库 fork 到自己的 GitHub 账号下

2. 登录 Vercel#

访问 Vercel 控制台，使用 GitHub 账号登录。

3. 导入项目#

点击「Add New」→「Project」
在「Import Git Repository」部分，找到并选择你刚才 fork 的 Umami 仓库
点击「Import」按钮

4. 配置项目#

在配置页面：

Project Name：保持默认或修改为你喜欢的名称
Framework Preset：选择「Next.js」
Root Directory：保持默认
Build and Output Settings：保持默认

5. 设置环境变量#

在「Environment Variables」部分，点击「Add」按钮，添加以下环境变量：

变量名	值	说明
`DATABASE_URL`	你的 Supabase 连接字符串	数据库连接地址
`HASH_SALT`	随机字符串	用于密码哈希，建议使用随机生成的字符串

注意：

DATABASE_URL 就是你在 Supabase 中复制的连接字符串
HASH_SALT 可以使用在线工具生成一个随机字符串

6. 部署项目#

点击「Deploy」按钮，等待部署完成。部署过程可能需要 2-3 分钟。

7. 访问项目#

部署完成后，Vercel 会生成一个域名，点击「Visit」按钮即可访问 Umami 应用。

步骤三：配置 Umami#

1. 登录 Umami#

访问部署后的 Umami 网站
使用默认账号登录：
- 用户名：admin
- 密码：umami

2. 修改默认密码(重要)#

登录后，点击右上角的用户头像
选择「Profile」
在「Password」部分，输入新密码
点击「Save」按钮

3. 添加网站#

点击左侧菜单的「Websites」
点击「Add Website」按钮
填写网站信息：
- Name：网站名称
- Domain：网站域名
点击「Save」按钮

4. 获取跟踪代码#

在网站列表中，找到你刚刚添加的网站
点击右侧的「」图标
复制跟踪代码
将跟踪代码添加到你网站的标签中

步骤四：验证部署#

1. 检查数据统计#

访问你添加的网站
浏览几个页面
回到 Umami 控制台，查看「Real-time」数据
确认能看到访问数据

2. 检查历史数据#

等待一段时间（约 5-10 分钟）
回到 Umami 控制台
查看「Dashboard」页面
确认能看到历史访问数据

常见问题及解决方案#

1. 数据库连接失败#

症状：部署后无法访问，或显示数据库连接错误

解决方案：

检查 DATABASE_URL 环境变量是否正确
确认 Supabase 项目是否正常运行
检查数据库密码是否正确

2. 跟踪代码不工作#

症状：网站访问后，Umami 中没有数据

解决方案：

确认跟踪代码是否正确添加到网站中
检查浏览器控制台是否有错误
确认网站域名是否与 Umami 中添加的域名一致

3. 部署失败#

症状：Vercel 部署过程中出现错误

解决方案：

检查环境变量是否正确设置
确认 Umami 版本是否与 Vercel 兼容
查看部署日志，根据错误信息进行修复

总结#

通过以上步骤，你已经成功在 Vercel 上部署了 Umami，并使用 Supabase 作为数据库。现在你可以：

实时监控网站访问数据
查看详细的用户行为分析
导出数据进行进一步分析
完全掌控你的网站分析数据

Umami 是一个非常优秀的开源网站分析工具，结合 Vercel 和 Supabase 的免费服务，你可以零成本搭建一个功能完整的网站分析系统。

项目资源#

Umami GitHub 仓库：https://github.com/umami-software/umami
Vercel 官网：https://vercel.com
Supabase 官网：https://supabase.com

希望这篇指南对你有所帮助！如果你在部署过程中遇到任何问题，欢迎在评论区留言。

从“小白”到“大神”，Docker安装使用全攻略

2026-04-11T18:31:13.000Z

从“小白”到“大神”，Docker安装使用全攻略#

Docker 是什么#

d0be9584-4b4d-4460-892a-b1022ac72a9f_1753441077954019004_origin~tplv-a9rns2rl98-image-qvalue

Docker，简单来说，是一种开源的应用容器引擎，可以将应用程序及其依赖环境打包成一个可移植的容器，然后在任何支持 Docker 的环境中运行。它就像是一个超级 “集装箱”，把应用程序以及它运行所需要的各种 “零件”，如代码、运行时环境、系统工具、库文件等等，全部打包在一起。这样不管这个 “集装箱” 被运到哪里，只要有能运行它的基础环境，应用程序都能以相同的方式运行，不会因为环境的变化而出现问题。

和传统的虚拟机相比，Docker 容器不需要像虚拟机那样为每个应用运行一个完整的操作系统，而是直接共享宿主机的操作系统内核，这使得它更加轻量级，启动速度更快，占用的资源也更少。在相同的硬件资源下，可以部署更多的容器实例，从而提高了服务器资源的利用率。

Docker 主要有三大核心概念，即镜像（Image）、容器（Container）和仓库（Repository）：

镜像：可以把它理解成一个只读的模板，包含了运行一个特定应用程序所需的所有文件系统内容，包括代码、运行时环境、库、依赖项等，就像是一个应用程序的 “快照”，定义了容器的初始状态。例如，一个基于 Python 的 Web 应用程序，其镜像会包含 Python 解释器、应用代码、所需的第三方库以及相关的配置文件等。
容器：容器是镜像的运行实例，是从镜像创建出来的可运行的实体，可以看作是一个轻量级的、独立运行的操作系统环境，与宿主机以及其他容器相互隔离。容器在运行时可以被启动、停止、暂停等操作，每个容器都有自己独立的文件系统、网络空间和进程空间等。比如，基于上述 Python Web 应用的镜像创建的容器，就是该应用实际运行的环境，它可以接收网络请求并处理业务逻辑。
仓库：Docker 仓库是用来存储镜像的地方，分为公共仓库和私有仓库。公共仓库如 Docker Hub，提供了大量的官方和社区维护的镜像，供用户免费下载和使用；私有仓库则通常由企业或组织自己搭建和管理，用于存储内部使用的镜像，以保证镜像的安全性和私密性。

为什么要用 Docker#

Docker 之所以在近年来如此火爆，成为众多开发者和企业的首选，是因为它能解决许多传统应用部署方式中存在的痛点，为软件开发和运维带来了极大的便利和效率提升。下面我们来详细探讨一下为什么要使用 Docker。

环境一致性保障：在传统的开发与部署流程中，开发、测试和生产环境往往存在差异，这就导致了常说的 “在我机器上可以运行” 但在其他环境中出现故障的问题。不同的操作系统版本、软件库的安装与配置不同，都可能使得应用程序在不同环境中的表现不一致，增加了调试和部署的难度。而 Docker 通过将应用程序及其依赖环境打包成一个镜像，确保了无论在开发、测试还是生产环境中，运行环境都是完全一致的。只要有支持 Docker 的运行时，应用就能以相同的方式运行，大大减少了因环境问题导致的部署失败和调试时间，提高了软件的可移植性和可靠性。
快速部署与扩展：Docker 容器的启动速度极快，通常只需要几秒钟，相比传统虚拟机的几分钟启动时间，极大地提高了应用的部署速度。当业务需求发生变化，需要扩展或缩减应用的规模时，使用 Docker 可以轻松实现。通过简单的命令，就可以快速创建或删除容器实例，实现应用的弹性伸缩。例如，在电商促销活动期间，可以快速启动更多的容器来应对突增的流量；活动结束后，又能及时减少容器数量，节省资源成本。
资源利用率高：传统的虚拟化技术需要为每个应用运行一个完整的操作系统，这会占用大量的系统资源，包括内存、CPU 等。而 Docker 容器共享宿主机的操作系统内核，不需要额外的操作系统层，因此资源占用小，在相同的硬件资源下，可以部署更多的容器实例，从而提高了服务器资源的利用率，降低了硬件成本。
易于管理和维护：Docker 提供了统一的镜像管理和容器管理方式，通过简单的命令，就可以对镜像和容器进行创建、删除、启动、停止、查看状态等操作，使得应用的管理和维护变得更加简单和高效。同时，Docker 还支持版本控制，开发者可以为不同版本的镜像打上标签，方便管理和追踪。当新版本的应用出现问题时，可以快速回滚到之前的稳定版本。

为了更直观地感受 Docker 的优势，我们来看一个具体的案例。假设有一个开发团队正在开发一个基于微服务架构的电商平台，该平台包含用户服务、商品服务、订单服务等多个微服务。在传统的部署方式下，每个微服务都需要单独配置运行环境，安装相应的依赖项，这是一个繁琐且容易出错的过程。而且，不同微服务之间可能会因为依赖项的冲突或环境配置的差异而出现问题。使用 Docker 后，每个微服务都可以被打包成一个独立的容器，这些容器之间相互隔离，互不影响。开发团队可以在本地开发环境中轻松地创建和管理这些容器，确保每个微服务都能正常运行。在部署到生产环境时，只需要将这些容器镜像推送到生产服务器上，然后使用简单的命令就可以启动所有的微服务容器，大大缩短了部署时间，提高了部署的可靠性。当某个微服务需要升级或修复时，只需要更新对应的容器镜像，然后重新启动容器即可，不会影响到其他微服务的正常运行。

Docker 安装教程#

了解了 Docker 的强大功能后，接下来我们就进入实战环节，看看如何在不同的操作系统上安装 Docker。

Windows 系统安装#

在 Windows 系统下，我们可以通过安装 Docker Desktop 来使用 Docker。Docker Desktop 是一个用于在 Windows 上轻松构建、管理和运行容器化应用程序的工具，它集成了 Docker 引擎、CLI 客户端和 Kubernetes 等组件。

具体安装步骤如下：

检查系统要求：确保你的 Windows 系统满足以下条件：Windows 10 64 位（专业版、企业版或教育版）或 Windows 11；64 位处理器，支持虚拟化（Intel VT-x 或 AMD-V）；至少 4GB 内存。你可以通过运行systeminfo命令来查看系统信息，确认是否支持虚拟化。在输出结果中，找到 “Hyper-V Requirements” 部分，如果 “虚拟化已启用” 显示为 “是”，则说明系统支持虚拟化；若为 “否”，则需要进入 BIOS 或 UEFI 设置中启用虚拟化功能。不同品牌的计算机进入 BIOS 的方式可能不同，一般在开机时按下 F2、F10、Delete 等键，具体按键可参考计算机的用户手册。在 BIOS 设置中，找到 “Virtualization Technology” 或 “VT-x”（Intel）/“AMD-V”（AMD）选项，将其设置为 “Enabled” 启用，然后保存并退出 BIOS 。
安装 WSL 2：WSL（Windows Subsystem for Linux）是 Windows 的一个功能，允许你在 Windows 上运行 Linux 二进制可执行文件。Docker Desktop 依赖 WSL 2 作为后端引擎，因此需要先安装 WSL 2 。以管理员身份运行 PowerShell，执行wsl --install命令，该命令会自动安装最新版本的 WSL 及其核心组件，并设置 WSL 2 为默认版本。安装完成后，重启计算机。如果执行wsl --install命令时提示错误，可能是因为系统版本不支持或其他原因。你可以尝试手动安装 WSL 2，具体步骤如下：首先，下载适用于 Linux 的内核更新包，下载地址：http s://w slsto resto rage.blob.core.windo ws.ne t/wsl blob/wsl_u pdate _x64.msi 。下载完成后，运行安装包进行安装。然后，以管理员身份运行 PowerShell，执行wsl --set-default-version 2命令，设置 WSL 2 为默认版本。
下载 Docker Desktop：访问 Docker 官网下载页面（ht tps://www.docke r.com /prod ucts/docke r-des ktop/），点击 “Download for Windows” 按钮，下载最新版本的 Docker Desktop 安装程序。
安装 Docker Desktop：找到下载的安装文件（通常在 “下载” 文件夹中），双击安装文件，启动安装向导。在安装过程中，按照提示进行操作，建议保留默认设置。在 “Configuration” 页面，确保选择 “Use the WSL 2 based engine” 选项，以使用 WSL 2 作为容器后端。安装完成后，可能需要重启计算机。
验证安装：打开命令提示符（CMD）或 PowerShell，输入docker --version命令，验证 Docker 是否安装成功。如果安装成功，该命令将输出当前安装的 Docker 版本信息，例如 “Docker version 24.0.6, build ed223bc” 。你还可以运行docker run hello-world命令来测试 Docker 是否正常工作。该命令会从 Docker Hub 下载一个测试镜像，并在容器中运行它。如果一切顺利，你将看到 “Hello from Docker!” 的输出信息，表明 Docker 已成功安装并可以正常使用。

在安装过程中，可能会遇到一些问题，比如虚拟化未开启、缺少 WSL 2 工具等。针对这些问题，可以参考以下解决方案：

虚拟化未开启：如果在安装 Docker Desktop 时提示虚拟化未开启，按照上述 “检查系统要求” 步骤中提到的方法，进入 BIOS 或 UEFI 设置中启用虚拟化功能。
缺少 WSL 2 工具：如果提示缺少 WSL 2 工具，按照上述 “安装 WSL 2” 步骤中提到的方法，安装 WSL 2 。
安装过程中出现其他错误：如果在安装过程中出现其他错误，可以查看 Docker Desktop 的安装日志，日志文件位于 “C:\Users\ 你的用户名 \AppData\Local\Docker\log” 目录下。根据日志文件中的错误信息，在 Docker 官方文档或社区论坛中查找解决方案。

Linux 系统安装（以 Ubuntu 为例）#

在 Ubuntu 系统中，安装 Docker 也非常简单，只需要几个命令即可完成。以下是具体的安装步骤：

更新软件包列表：在安装 Docker 之前，首先需要更新系统的软件包列表，以获取最新的软件包信息。打开终端，运行以下命令：

1
sudo apt-get update

安装依赖：Docker 依赖一些必要的软件包，我们需要先安装它们。运行以下命令：

1
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

其中，apt-transport-https允许apt包管理器通过 HTTPS 协议与软件源进行通信；ca-certificates包含了根证书，用于验证 SSL/TLS 连接的安全性；curl是一个命令行工具，用于通过 URL 下载文件；gnupg是一个用于加密和签名的工具；lsb-release用于显示系统的发行版信息。

3. 添加 GPG 密钥：为了确保从 Docker 官方仓库下载的软件包的完整性和安全性，我们需要添加 Docker 官方的 GPG 密钥。运行以下命令：

1
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

添加软件源：将 Docker 官方的软件源添加到系统的软件源列表中，以便系统能够从该源下载 Docker 软件包。运行以下命令：

1
echo "deb \[arch=\$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \$(lsb\_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

再次更新软件包列表：添加软件源后，需要再次更新软件包列表，使系统能够识别新添加的软件源。运行以下命令：

1
sudo apt-get update

安装 Docker 引擎：现在可以安装 Docker 引擎了，运行以下命令：

1
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

其中，docker-ce是 Docker 社区版的核心引擎；docker-ce-cli是 Docker 的命令行工具；containerd.io是一个开源的容器运行时；docker-compose-plugin是用于定义和运行多容器 Docker 应用程序的插件。

7. 验证安装：安装完成后，可以通过查看 Docker 的版本信息和运行测试镜像来验证安装是否成功。运行以下命令查看版本信息：

1
docker --version

运行以下命令运行测试镜像：

1
sudo docker run hello-world

如果安装成功，运行docker --version命令会输出 Docker 的版本号，运行sudo docker run hello-world命令会下载一个测试镜像并在容器中运行它，输出 “Hello from Docker!” 等信息。

MacOS 系统安装#

在 MacOS 系统上，我们同样可以通过安装 Docker Desktop 来使用 Docker 。以下是具体的安装步骤：

下载 Docker Desktop：打开浏览器，访问 Docker 官网下载页面（http s://w ww.do cker.com/p roduc ts/do cker-deskt op/），点击 “Download for Mac” 按钮，下载最新版本的 Docker Desktop 安装程序。
安装 Docker Desktop：下载完成后，双击下载的.dmg文件，将 Docker 图标拖放到 “应用程序” 文件夹中，完成安装。
启动 Docker Desktop：打开 “应用程序” 文件夹，找到 Docker 并双击打开。首次启动时，可能会要求输入你的 MacOS 账号密码以授权。
基本配置：启动 Docker Desktop 后，可以根据自己的需求进行一些基本配置。点击菜单栏中的 Docker 图标，选择 “Preferences”，在弹出的窗口中可以进行以下配置：

Resources：在这里可以分配给 Docker 的 CPU、内存和磁盘空间等资源。根据实际需求合理调整这些参数，以确保 Docker 能够在你的系统上稳定运行。例如，如果你的项目对内存要求较高，可以适当增加分配给 Docker 的内存大小。
Network：设置 Docker 的网络模式。默认情况下，Docker 会创建一个桥接网络，容器可以通过该网络与主机和其他容器进行通信。如果你的项目有特殊的网络需求，也可以在这里进行自定义设置。
Docker Engine：手动配置 Docker 引擎的 JSON 设置。一般情况下，保持默认设置即可。但如果你对 Docker 的运行机制有深入了解，并且有特定的配置需求，也可以在这里进行修改。

验证安装：打开终端（Terminal），输入docker --version命令，验证 Docker 是否安装成功。如果安装成功，该命令将输出当前安装的 Docker 版本信息。你还可以运行docker run hello-world命令来测试 Docker 是否正常工作。如果一切顺利，你将看到 “Hello from Docker!” 的输出信息，表明 Docker 已成功安装并可以正常使用。

Docker 基本使用#

在掌握了 Docker 的安装方法后，接下来让我们深入了解 Docker 的基本使用方法，包括镜像操作、容器操作和数据管理等方面，这些操作是使用 Docker 进行应用部署和管理的基础。

镜像操作#

下载镜像：Docker Hub 是一个公共的镜像仓库，我们可以使用docker pull命令从 Docker Hub 下载镜像。例如，要下载最新版本的 Nginx 镜像，可以执行以下命令：

1
docker pull nginx

在上述命令中，如果不指定具体的版本标签，docker pull命令会默认下载镜像的latest标签版本，即最新版本。如果需要下载特定版本的镜像，可以在镜像名称后加上版本标签，例如下载 Nginx 的 1.23.1 版本镜像，命令如下：

1
docker pull nginx:1.23.1

构建自定义镜像：当官方提供的镜像无法满足我们的需求时，就需要基于Dockerfile来构建自定义镜像。Dockerfile是一个文本文件，其中包含了一系列用于构建镜像的指令和操作步骤。例如，我们要构建一个基于 Python 3.11 的 Web 应用镜像，假设Dockerfile的内容如下：

1
\# 使用官方Python 3.11镜像作为基础镜像
2

3
FROM python:3.11-slim
4

5
\# 设置工作目录为/app
6

7
WORKDIR /app
8

9
\# 将当前目录下的所有文件复制到容器的/app目录中
10

11
COPY. /app
12

13
\# 安装项目依赖，假设项目依赖文件为requirements.txt
14

15
RUN pip install -r requirements.txt
16

17
\# 暴露容器的8000端口，用于Web应用的访问
18

19
EXPOSE 8000
20

21
\# 设置容器启动时执行的命令，假设启动Web应用的命令为python main.py
22

23
CMD \["python", "main.py"]

展开收起

在包含上述Dockerfile的目录下，执行以下命令来构建镜像：

1
docker build -t my-python-web-app.

在这个命令中，-t参数用于指定镜像的标签，格式为[仓库名/][镜像名]:[标签] ，这里my-python-web-app就是我们给镜像指定的名称和标签。最后的.表示构建上下文为当前目录，即Dockerfile所在的目录，Docker 会在这个目录及其子目录中查找构建镜像所需的文件。

查看本地镜像列表：使用docker images命令可以查看本地已经下载或构建的镜像列表，命令执行结果会显示镜像的仓库名、标签、镜像 ID、创建时间和大小等信息，例如：

1
docker images

执行上述命令后，可能得到类似如下的输出：

1
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
2

3
nginx               latest              d1a364dc548d        3 weeks ago         133MB
4

5
my-python-web-app   latest              9c87f97e2f34        1 hour ago          256MB

从输出结果中，我们可以清晰地看到本地已有的镜像信息，方便我们对镜像进行管理和使用。

删除镜像：当某个镜像不再需要时，可以使用docker rmi命令将其删除。例如，要删除my-python-web-app:latest这个镜像，可以执行以下命令：

1
docker rmi my-python-web-app:latest

如果要删除多个镜像，可以在命令后依次列出镜像的名称和标签，或者使用镜像 ID 进行删除。需要注意的是，如果某个镜像正在被容器使用，直接删除该镜像会失败，需要先停止并删除依赖该镜像的容器，然后才能删除镜像。

容器操作#

创建并运行容器：使用docker run命令可以创建并运行一个容器。该命令的基本语法为docker run [OPTIONS] IMAGE [COMMAND] [ARG] ，其中OPTIONS是可选参数，IMAGE是指定的镜像名称，COMMAND是容器启动时要执行的命令，ARG是传递给命令的参数。例如，基于 Nginx 镜像创建并运行一个容器，将容器的 80 端口映射到主机的 8080 端口，命令如下：

1
docker run -d -p 8080:80 --name my-nginx nginx

在这个命令中：

-d参数表示以守护（后台）模式运行容器，容器会在后台运行，不会占用当前终端。
-p 8080:80表示将主机的 8080 端口映射到容器的 80 端口，这样通过访问主机的 8080 端口，就可以访问到容器内 Nginx 服务的 80 端口。
--name my-nginx为容器指定一个名称my-nginx，方便后续对容器进行管理和操作。
nginx是要使用的镜像名称。
查看正在运行的容器：使用docker ps命令可以查看当前正在运行的容器列表，命令执行结果会显示容器的 ID、使用的镜像、启动命令、创建时间、状态、端口映射和容器名称等信息，例如：

1
docker ps

执行上述命令后，可能得到类似如下的输出：

1
CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS          PORTS                                   NAMES
2

3
7f37a8c9c8c8   nginx     "/docker-entrypoint.…"   5 minutes ago    Up 5 minutes    0.0.0.0:8080->80/tcp, :::8080->80/tcp   my-nginx

从输出结果中，我们可以清楚地了解正在运行的容器的各项信息。如果要查看所有容器（包括已停止的容器），可以使用docker ps -a命令。

停止容器：当需要停止正在运行的容器时，可以使用docker stop命令，后面跟上容器的 ID 或名称。例如，停止名为my-nginx的容器，命令如下：

1
docker stop my-nginx

执行该命令后，容器会被优雅地停止，即容器内的应用程序会收到停止信号，有机会进行一些清理工作后再停止运行。

启动已停止的容器：对于已经停止的容器，可以使用docker start命令来重新启动它，同样后面跟上容器的 ID 或名称。例如，启动名为my-nginx的容器，命令如下：

1
docker start my-nginx

进入正在运行的容器内部：有时候我们需要进入正在运行的容器内部，执行一些命令或进行调试等操作，可以使用docker exec命令。例如，进入名为my-nginx的容器，并启动一个交互式的bash shell，命令如下：

1
docker exec -it my-nginx bash

在这个命令中，-i参数表示保持标准输入流打开，允许我们向容器内输入命令；-t参数表示为容器分配一个伪终端，使我们能够在终端中与容器进行交互。执行上述命令后，我们就可以在容器内部执行各种命令，就像在容器所在的主机上操作一样。

数据管理#

数据卷的概念和作用：在 Docker 中，容器的存储是临时的，当容器被删除时，容器内的数据也会随之丢失。为了解决数据持久化存储和共享的问题，Docker 引入了数据卷（Volume）的概念。数据卷是一个可供容器使用的特殊目录，它将主机操作系统目录直接映射进容器，或者由 Docker 管理一个存储区域并挂载到容器中。数据卷具有以下特点：
- 数据持久化：即使容器被删除，数据卷中的数据仍然会保留，不会丢失。
- 容器间共享：多个容器可以挂载同一个数据卷，实现数据的共享和传递。
- 读写性能高：数据卷直接绕过 Union File System，对数据卷的读写操作性能较高。
创建数据卷：使用docker volume create命令可以创建一个数据卷。例如，创建一个名为my-data-volume的数据卷，命令如下：

1
docker volume create my-data-volume

执行该命令后，Docker 会在主机上创建一个用于存储数据卷的目录，并生成一个唯一的数据卷 ID 。我们可以使用docker volume ls命令查看所有已创建的数据卷列表，使用docker volume inspect my-data-volume命令查看指定数据卷的详细信息，包括数据卷的名称、驱动、挂载点等。

挂载数据卷到容器：在使用docker run命令创建容器时，可以通过-v或--mount参数将数据卷挂载到容器中。例如，创建一个基于 Nginx 镜像的容器，并将名为my-data-volume的数据卷挂载到容器的/usr/share/nginx/html目录下，命令如下：

1
docker run -d -p 8080:80 --name my-nginx -v my-data-volume:/usr/share/nginx/html nginx

或者使用--mount参数的方式：

1
docker run -d -p 8080:80 --name my-nginx --mount source=my-data-volume,target=/usr/share/nginx/html nginx

这两种方式的效果是相同的，都是将my-data-volume数据卷挂载到容器的/usr/share/nginx/html目录，使得容器内该目录下的数据实际上存储在数据卷中。这样，当容器被删除并重新创建时，只要挂载相同的数据卷，容器内/usr/share/nginx/html目录下的数据仍然会保留。同时，如果有多个容器都挂载了同一个数据卷，它们之间就可以共享该数据卷中的数据。

实战演练#

为了更直观地感受 Docker 的强大功能和便捷性，我们通过一个具体的实战案例来深入了解它的使用方法。在这个案例中，我们将使用 Docker 部署一个简单的 Flask Web 应用。Flask 是一个轻量级的 Python Web 框架，非常适合用于快速开发小型 Web 应用。通过这个实战，你将掌握如何使用 Docker 构建、运行和管理一个 Web 应用容器。

项目准备#

创建项目目录：首先，在你的计算机上创建一个新的项目目录，例如flask - docker - demo，并进入该目录。

1
mkdir flask - docker - demo
2

3
cd flask - docker - demo

初始化 Python 虚拟环境（可选）：为了避免项目依赖与系统环境冲突，建议在项目目录下创建一个 Python 虚拟环境。如果你还没有安装virtualenv，可以使用以下命令进行安装（假设你已经安装了 Python）：

1
pip install virtualenv

创建并激活虚拟环境：

1
virtualenv venv
2

3
source venv/bin/activate  # Windows下使用 \`venv\Scripts\activate\`

安装 Flask：在激活的虚拟环境中，使用pip安装 Flask：

1
pip install flask

编写 Flask 应用代码：使用你喜欢的文本编辑器，在项目目录下创建一个名为app.py的文件，并编写以下 Flask 应用代码：

1
from flask import Flask
2

3
app = Flask(\_\_name\_\_)
4

5
@app.route('/')
6

7
def hello\_world():
8

9
    return 'Hello, Docker!'
10

11
if \_\_name\_\_ == '\_\_main\_\_':
12

13
    app.run(host='0.0.0.0', port=5000)

这段代码创建了一个简单的 Flask 应用，定义了一个根路由/，当访问该路由时，返回Hello, Docker! 。app.run(host='``0.0.0.0``', port=5000)表示应用监听在 0.0.0.0 地址的 5000 端口上，这样可以通过宿主机的 IP 地址和 5000 端口来访问该应用。

编写 Dockerfile#

接下来，我们需要编写一个Dockerfile来定义如何构建我们的 Docker 镜像。在项目目录下创建一个名为Dockerfile的文件（注意文件名大小写，且没有文件扩展名），并写入以下内容：

1
\# 使用官方Python 3.11镜像作为基础镜像
2

3
FROM python:3.11 - slim
4

5
\# 设置工作目录为/app
6

7
WORKDIR /app
8

9
\# 将当前目录下的所有文件复制到容器的/app目录中
10

11
COPY. /app
12

13
\# 安装项目依赖，假设项目依赖文件为requirements.txt，这里直接安装Flask
14

15
RUN pip install flask
16

17
\# 暴露容器的5000端口，用于Web应用的访问
18

19
EXPOSE 5000
20

21
\# 设置容器启动时执行的命令，运行Flask应用
22

23
CMD \["python", "app.py"]

展开收起

这个Dockerfile的具体解释如下：

FROM python:3.11 - slim：指定使用官方的 Python 3.11 精简版镜像作为基础镜像，该镜像包含了 Python 3.11 运行环境，且体积相对较小。
WORKDIR /app：设置容器内的工作目录为/app，后续的操作将在这个目录下进行。
COPY. /app：将当前目录（即项目目录flask - docker - demo）下的所有文件复制到容器的/app目录中。
RUN pip install flask：在容器内运行pip install flask命令，安装 Flask 及其依赖项。
EXPOSE 5000：声明容器内的应用将监听 5000 端口，这只是一个声明，并不实际进行端口映射。
CMD ["python", "``app.py``"]：指定容器启动时执行的命令，这里是运行app.py文件来启动 Flask 应用。

构建 Docker 镜像#

在包含Dockerfile和app.py的项目目录下，打开终端，执行以下命令来构建 Docker 镜像：

1
docker build -t flask - app.

在这个命令中：

-t参数用于指定镜像的标签，格式为[仓库名/][镜像名]:[标签] ，这里我们将镜像命名为flask - app，并使用默认的latest标签。
最后的.表示构建上下文为当前目录，即Dockerfile所在的目录，Docker 会在这个目录及其子目录中查找构建镜像所需的文件。

执行构建命令后，Docker 会读取Dockerfile中的指令，逐步构建镜像。在构建过程中，你会看到一系列的输出信息，显示每个步骤的执行情况。如果构建成功，最终会显示Successfully tagged flask - app:latest，表示镜像构建完成，并打上了flask - app:latest的标签。

运行 Docker 容器#

镜像构建完成后，我们可以使用docker run命令来运行容器。在终端中执行以下命令：

1
docker run -d -p 8080:5000 --name flask - container flask - app

这个命令的参数解释如下：

-d：表示以守护（后台）模式运行容器，容器会在后台运行，不会占用当前终端。
-p 8080:5000：将主机的 8080 端口映射到容器的 5000 端口，这样通过访问主机的 8080 端口，就可以访问到容器内 Flask 应用监听的 5000 端口。
--name flask - container：为容器指定一个名称flask - container，方便后续对容器进行管理和操作。
flask - app：指定要运行的镜像名称。

执行上述命令后，Docker 会从flask - app镜像创建一个容器并运行它。你可以使用docker ps命令查看正在运行的容器列表，确认容器是否成功启动。如果容器启动成功，在docker ps的输出中，你会看到flask - container容器正在运行，并且端口映射为0.0.0.0:8080``->5000/tcp 。

访问 Web 应用#

现在，打开你的浏览器，在地址栏中输入http://localhost:8080，如果一切顺利，你将看到浏览器页面上显示Hello, Docker! ，这表明我们使用 Docker 部署的 Flask Web 应用已经成功运行。

通过这个实战案例，我们展示了使用 Docker 部署一个简单 Web 应用的完整过程，包括项目准备、编写Dockerfile、构建镜像和运行容器。希望这个案例能帮助你更好地理解和掌握 Docker 的基本使用方法，为你在实际项目中应用 Docker 打下坚实的基础。

常见问题及解决方法#

在安装和使用 Docker 的过程中，可能会遇到一些问题，下面为大家整理了一些常见问题及对应的解决方法。

镜像下载缓慢#

问题描述：在使用docker pull命令下载镜像时，速度非常慢，甚至可能会出现下载超时的情况。
原因分析：Docker 默认使用的是国外的官方镜像源，由于网络原因，国内访问可能会受到限制，导致下载速度缓慢。
解决方法：可以通过配置国内的镜像加速器来提高镜像下载速度。常见的国内镜像加速器有阿里云镜像加速器、网易云镜像加速器、中科大镜像加速器等。以阿里云镜像加速器为例，配置步骤如下：
- Windows 系统：打开 Docker Desktop，点击任务栏中的 Docker 图标，选择 “Settings”，在弹出的窗口中选择 “Docker Engine” 选项卡。在 “Registry mirrors” 字段中，添加阿里云提供的专属镜像加速地址（需要先登录阿里云容器镜像服务获取），格式如下：

1
{
2

3
  "registry-mirrors": \["https://xxxxxx.mirror.aliyuncs.com"]
4

5
}

添加完成后，点击右下角的 “Apply & Restart” 按钮，Docker 会自动重启并应用新的镜像源配置。

Linux 系统：首先，创建或编辑 Docker 的配置文件/etc/docker/daemon.json（如果文件不存在则创建），添加以下内容：

1
{
2

3
  "registry-mirrors": \["https://xxxxxx.mirror.aliyuncs.com"]
4

5
}

然后，保存文件并执行以下命令使配置生效：

1
sudo systemctl daemon-reload
2

3
sudo systemctl restart docker

配置完成后，可以使用docker info命令查看配置是否生效，在输出信息中找到 “Registry Mirrors” 字段，确认其值为配置的镜像加速地址。之后再使用docker pull命令下载镜像，速度应该会有明显提升。

容器启动失败#

问题描述：使用docker run命令启动容器时，容器无法正常启动，可能会出现报错信息。
原因分析：容器启动失败的原因可能有很多，常见的包括镜像损坏、容器配置错误、端口冲突、依赖服务未启动等。
解决方法：
- 检查镜像完整性：首先，使用docker images命令查看本地镜像列表，确认要启动容器的镜像是否存在且完整。如果镜像损坏，可以尝试重新下载或重新构建镜像。例如，如果怀疑nginx:latest镜像有问题，可以先删除该镜像（docker rmi nginx:latest），然后重新下载（docker pull nginx:latest）。
- 检查容器配置：仔细检查docker run命令的参数是否正确，例如端口映射是否合理、容器名称是否重复等。如果使用了Dockerfile构建镜像并启动容器，还要检查Dockerfile中的指令是否正确，例如工作目录是否设置正确、应用启动命令是否正确等。
- 检查端口冲突：如果在启动容器时指定了端口映射（如-p 8080:80），而该端口在主机上已经被其他进程占用，就会导致容器启动失败。可以使用netstat命令或lsof命令检查端口占用情况。以netstat命令为例，在 Linux 系统中，可以执行netstat -tunlp | grep 8080命令查看 8080 端口的占用情况。如果发现端口被占用，可以修改容器的端口映射，或者停止占用该端口的进程。
- 检查依赖服务：如果容器依赖其他服务（如数据库、消息队列等），确保这些依赖服务已经正常启动并可以被容器访问。例如，一个 Web 应用容器可能依赖 MySQL 数据库，在启动 Web 应用容器之前，要确保 MySQL 数据库已经正常运行，并且 Web 应用容器的数据库连接配置正确。可以通过在容器内使用ping命令或其他工具测试对依赖服务的连通性。如果是因为依赖服务未启动导致容器启动失败，先启动依赖服务，然后再尝试启动容器。

总结与展望#

通过本文，我们全面了解了 Docker 这一强大的容器化技术，从它的基本概念、安装方法，到镜像操作、容器管理以及数据卷的使用，还通过一个 Flask Web 应用的实战案例，完整地体验了使用 Docker 进行应用部署的流程。同时，我们也探讨了在使用过程中可能遇到的问题及解决办法。

Docker 的出现，极大地改变了传统的应用部署和运维模式，它以其环境一致性、快速部署、高效资源利用等优势，成为了现代软件开发和运维的必备工具。无论是开发个人项目，还是构建企业级的大型应用，Docker 都能为我们提供更加便捷、高效的解决方案。

对于各位读者，希望你们能将所学的 Docker 知识运用到实际项目中。在实践的过程中，不断探索 Docker 的更多高级特性和应用场景，例如使用 Docker Compose 进行多容器应用的编排，结合 Kubernetes 实现容器的自动化管理和集群部署等。相信随着对 Docker 的深入了解和使用，它会为你的工作和学习带来意想不到的便利和效率提升。

展望未来，随着云计算、大数据、人工智能等技术的不断发展，Docker 作为容器化技术的代表，将在这些领域发挥更加重要的作用。在云计算中，Docker 将助力实现更加灵活、高效的云原生应用部署和管理；在大数据处理中，Docker 可以为不同的数据处理框架和工具提供统一的运行环境，提高数据处理的效率和可靠性；在人工智能领域，Docker 能够方便地部署和管理深度学习模型，加速模型的训练和推理过程。可以预见，Docker 的应用前景将更加广阔，它将继续推动技术的创新和发展。让我们一起期待 Docker 在未来带给我们更多的惊喜！

（注：文档部分内容可能由 AI 生成）

服务器安全管理不用愁！Jumpserver 开源堡垒机，企业级安全解决方案

2026-04-11T18:31:13.000Z

朋友们！服务器安全管理太头疼？#

今天我要给大家推荐一个超好用的开源堡垒机——Jumpserver，它开源免费、功能强大，而且部署简单，是企业级服务器安全管理的理想选择！

什么是 Jumpserver？#

Jumpserver 是国内开源的企业级堡垒机项目，专注于解决企业服务器访问安全管理问题。它就像服务器的”安全门卫”，统一管理所有服务器的访问权限，记录所有操作行为，让服务器管理变得既安全又高效。

为什么推荐 Jumpserver？#

1️⃣ 开源免费，零成本使用#

Jumpserver 完全开源，免费使用，企业不需要为高昂的商业堡垒机 license 发愁，大大降低了企业的 IT 成本。

2️⃣ 统一认证，单点登录#

支持 LDAP、Radius、OAuth 等多种认证方式，实现单点登录，不用再记一堆账号密码，登录一次就能访问所有服务器。

3️⃣ 细粒度权限控制#

基于用户、用户组、资产、资产组的四维度权限管理，精确控制谁能访问哪些服务器，权限设置非常灵活。

4️⃣ 完整审计，合规无忧#

操作日志、命令记录、录像回放，所有操作都有迹可循，满足金融、政府等行业的严格合规要求。

5️⃣ 多协议支持#

SSH、RDP、Telnet、VNC 等多种协议统一管理，不管是什么类型的服务器，都能通过 Jumpserver 统一访问。

6️⃣ 多云支持#

适配各种云环境和混合云架构，不管你的服务器在哪个云平台，都能统一管理。

7️⃣ 安全加固#

支持 MFA、IP 限制、会话管理等安全措施，进一步提升服务器访问的安全性。

如何部署 Jumpserver？#

准备一台干净的 Linux 服务器 ( 64 位, >= 4c8g )

Terminal window

1
curl -sSL https://github.com/jumpserver/jumpserver/releases/latest/download/quick_start.sh | bash

在浏览器中访问 JumpServer，地址为 http://your-jumpserver-ip/

用户名: admin
密码: ChangeMe

通过测试来看，Jumpserver 的功能非常强大，操作也很简单。呵呵是不是很实用？

最重要的是，Jumpserver 解决了传统服务器管理的安全痛点，让服务器管理变得既安全又高效，这一点真的很贴心！

适合谁用？#

企业 IT 运维团队：管理大量服务器的访问权限
金融行业：需要满足严格的审计和合规要求
DevOps 团队：为开发和运维提供安全的服务器访问通道
多云环境：统一管理不同云平台的服务器资源
远程办公：为远程办公提供安全的服务器访问方式

项目资源#

如果你对 Jumpserver 感兴趣，可以访问以下资源：

GitHub地址: https://github.com/jumpserver/jumpserver

觉得项目不错可以点个赞。

官方网站: https://www.jumpserver.org/

在线文档: https://docs.jumpserver.org/

互动时间#

你们平时是如何管理服务器的？使用 Jumpserver 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

不用买Mac！飞牛NAS用 Docker 跑 macOS，当云电脑用真香！

2026-04-11T18:31:13.000Z

哈喽，小伙伴们！#

大家好呀～今天要给你们分享一个超酷的玩法！

你是不是也想体验 macOS 系统，但又不想花大价钱买 Mac？或者偶尔需要用一下 Mac 环境，却没有设备？

别着急，今天教你一个神操作——用飞牛NAS + Docker 跑 macOS，直接把 macOS 装进容器里，随时随地当云电脑用！

为什么要这么玩？#

对于喜欢折腾 NAS、服务器或者开发环境的朋友来说，这种方式真的太香了：

✅ 省钱：不用买昂贵的 Mac 设备
✅ 灵活：随时随地通过网络访问
✅ 多用途：测试 macOS 软件、远程办公、开发环境
✅ 好玩：体验一下把 macOS 装进容器的乐趣

飞牛 Docker 部署步骤#

1️⃣ 准备工作#

首先，我们需要创建一个文件夹，用来存放 docker-compose.yml 文件和相关配置。

2️⃣ 部署容器#

打开 Docker，点击侧栏的「Compose」→「新增项目」→输入项目名称→设置路径选择刚才创建的文件夹→创建 docker-compose.yml 文件，把下面的代码复制进去：

1
services:
2
  macos:
3
    image: dockurr/macos
4
    container_name: macos
5
    environment:
6
      # CPU核心数（不得超出物理机总核心数）
7
      CPU_CORES: "4"
8
      # macOS版本：
9
      #     15  macOS 15  Sequoia
10
      #     14  macOS 14  Sonoma
11
      #     13  macOS 13  Ventura
12
      #     12  macOS 12  Monterey
13
      #     11  macOS 11  Big Sur
14
      VERSION: "12"
15
      # 磁盘大小（单位G，必须携带）
16
      DISK_SIZE: "60G"
17
      # 内存大小（单位G，必须携带）
18
      RAM_SIZE: "8G"
19
    devices:
20
      - /dev/kvm
21
      - /dev/net/tun
22
    cap_add:
23
      - NET_ADMIN
24
    ports:
25
      # 8006为 Web vnc 端口，5900为vnc端口
26
      # 修改端口仅改动冒号左侧，如：12345:8006
27
      - 8006:8006
28
      - 5900:5900/tcp
29
      - 5900:5900/udp
30
    volumes:
31
        # macos为自己建的目录，挂载本地文件夹到容器，用于存储 macOS 系统文件
32
      - ./macos:/storage
33
    restart: always
34
    stop_grace_period: 2m

展开收起

3️⃣ 查看部署进度#

构建完成后，去容器查看日志进度，当看到相关提示后，就可以在浏览器访问 ip<8006> 进入 web 端查看下载进度啦！

4️⃣ 系统安装设置#

接下来就是 macOS 的安装过程，按照以下步骤操作：

选择语言：设置为中文
磁盘工具：双击打开磁盘工具
格式化磁盘：选择最大容量的 Apple Inc. VirtIO Block Media 磁盘，点击抹掉，格式化为 APFS
安装系统：关闭磁盘工具，双击重新安装 macOS Monterey
完成设置：一路点击继续，选择刚才格式化的磁盘，耐心等待安装完成

实际使用体验#

部署完成后，你就拥有了一台可以远程访问的 macOS 云电脑！

流畅度：虽然通过网络访问，但是基本的日常使用完全没问题
功能：可以安装各种 macOS 软件，满足基本需求
便捷性：随时随地通过浏览器访问，不用携带设备

小提示#

部署时注意设置合适的磁盘大小，空间不够会导致部署失败
安装过程可能需要 1 小时左右，取决于你的存储设备速度

总结#

用飞牛 NAS + Docker 跑 macOS，真的是一个既省钱又实用的方案！

不用花大价钱买 Mac，就能随时体验 macOS 系统，对于开发者、设计师或者只是想尝鲜的朋友来说，都是一个不错的选择。

你也可以把它当作一台云电脑，随时随地通过网络访问，处理一些需要 macOS 环境的任务。

感兴趣的小伙伴赶紧试试吧！如果遇到问题，欢迎在评论区留言讨论～

互动时间：你最想在这台 macOS 云电脑上做什么？欢迎在评论区分享你的想法！

（注：文章部分图片来源于网络，如有侵权请联系删除）

2026最新整理！这几款观影软件太香了，电影爱好者福音！

2026-04-11T18:31:13.000Z

朋友们！最近好多人问我要观影软件，安排上了！#

最近后台有好多读者问我：“小王，有没有好用的看电影软件推荐？”、“片荒了，有没有什么好的观影工具？”。

为了满足大家的需求，我花了几天时间整理了一波好用的观影软件，涵盖了不同平台、不同需求，现在分享给大家！

整理的观影软件有哪些？#

这次整理的观影软件包括：

Android 平台：适合安卓手机、平板用户的观影软件
TV 端：适合智能电视、机顶盒用户的观影软件

为什么推荐这些软件？#

1️⃣ 资源丰富#

整理的软件涵盖了多种影视资源，包括电影、电视剧、动漫、综艺等，满足不同人的需求。

2️⃣ 界面美观#

这些软件的界面设计都很美观，操作简单，用户体验良好。

3️⃣ 播放流畅#

大多数软件都支持多种清晰度选择，播放流畅，不会卡顿。

4️⃣ 免费使用#

整理的软件都是免费使用的，不需要付费订阅。

5️⃣ 安全可靠#

我对每款软件都进行了测试，确保安全可靠，不会有恶意广告或插件。

如何获取这些软件？#

我已经将整理好的软件打包上传到了 123 云盘，大家可以通过以下链接下载： 分享地址：https://www.123684.com/s/lIPjjv-yzKid?pwd=5O1T#

提取码：5O1T

使用方法#

步骤1：下载并安装软件#

点击上面的分享链接，输入提取码 5O1T
下载压缩包到本地
解压压缩包，里面包含了所有软件和使用说明
根据自己的设备类型选择对应的软件
安装软件到设备上

步骤2：配置源（以XMBOX为例）#

打开XMBOX应用
- 安装完成后，打开XMBOX应用
进入设置界面
- 手机版：点击右上角的设置图标
- TV版：使用遥控器导航到设置选项
添加源
- 找到”配置”或”源管理”选项
- 点击”添加源”或”配置源”
- 在输入框中粘贴源地址
- 点击”确定”或”保存”按钮
开始使用
- 返回主界面，即可看到加载的影视资源
- 选择你想看的电影或电视剧开始观看

其他观影软件的配置方法类似,本次这些软件都是多仓版本,输入多仓的源即可使用。如果你没有可用的源，可以私信小王发送【观影源】获取最新源地址，这些源小王都会定期更新的，建议大家保持关注哈。

注意事项#

请在合法范围内使用这些软件，支持正版影视
部分软件可能需要网络环境支持，请确保网络畅通
如遇到软件无法使用的情况，可以在评论区留言，我会尽力解答
软件可能会定期更新，请关注最新版本
源地址可能会失效，需要定期更新源地址
重要：部分源内有广告，请勿相信广告，请勿点击不明链接！！！

互动时间#

你们平时都用什么软件看电影？有什么好的观影软件推荐？使用我分享的软件后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

温馨提示#

观影虽好，也要注意休息哦！建议大家合理安排观影时间，保护好眼睛。

推荐阅读：

解决GitHub访问慢的神器！fetch-github-hosts 让你秒开GitHub
不想修改hosts？这个神器更简单！SteamTools 让你一键加速GitHub和Steam，告别网络问题
发现宝藏音乐软件！LX Music 让你告别多 app 切换，一个软件听遍所有平台（注：文章部分信息来源于个人整理和测试）

服务器运维新革命！GMSSH 桌面级AI运维系统，让小白也能轻松管理服务器

2026-04-11T18:31:13.000Z

朋友们！服务器运维太复杂？这个工具让运维变得超简单！#

前几天有读者在后台问我：“小王，有没有什么好用的服务器管理工具推荐？“，作为一个经常需要管理服务器的人，我太懂这种感受了——传统的命令行操作太复杂，新手根本看不懂，而且容易出错。

今天我要给大家推荐一个超级好用的服务器运维工具——GMSSH，它是一个桌面级 AI 运维系统，让服务器管理变得可视化、智能化，即使是运维小白也能轻松上手！

什么是 GMSSH？#

GMSSH 是一款桌面级 AI 运维系统，专为 Linux 服务器设计，通过 SSH 可视化管理工具，让服务器运维变得简单高效。它结合了桌面 GUI 和 AI 智能引导，让新手也能秒懂服务器状态，通过拖拽式操作轻松完成复杂任务。

为什么推荐 GMSSH？#

1️⃣ 可视化桌面界面#

GMSSH 提供了直观的桌面界面，让服务器管理变得可视化：

拖拽上传下载，就像操作本地文件夹
右键压缩/解压，支持 tar.gz、zip 等主流格式
双击在线编辑，语法高亮 + 自动保存
可视化权限管理，点击即改

2️⃣ AI 智能运维#

这是 GMSSH 最具革命性的功能！通过自然语言交互，智能解析运维需求，自动执行命令、实时监控资源、精准定位问题，实现高效运维。

比如你可以直接说：

“帮我部署一个 WordPress 网站”
“查看系统资源使用情况”
“优化服务器性能”

AI 会自动帮你完成这些操作！

3️⃣ 零侵入设计#

GMSSH 的设计非常轻量：

等同原生命令行，不装代理
不开端口，不占资源
无需在服务器安装，直接通过 SSH 连接即可使用

4️⃣ 安全可靠#

基于原生 SSH 通道，融合 MFA 多因素认证与全链路审计，安全无妥协，合规即就绪。复用现有密钥，通信全程防窃听、防篡改。

5️⃣ 监控运维一体#

实时监控进程与系统资源，精准掌握 CPU、内存、磁盘、网络状态，低耗稳定连接，高负载下依旧流畅运行。

主要功能#

文件管理#

拖拽上传下载文件
右键压缩/解压文件
在线编辑文件
可视化权限管理

用户管理#

Linux 用户管理
SSH 配置与证书管理
DNS 设置
精细权限控制

系统监控#

实时监控进程与系统资源
精准掌握 CPU、内存、磁盘、网络状态
低耗稳定连接

AI 智能运维#

自然语言交互
智能解析运维需求
自动执行命令
实时监控资源
精准定位问题

如何使用 GMSSH？#

步骤1：下载安装#

访问 GMSSH 官网：https://www.gmssh.com/
下载适合你系统的安装包
运行安装程序，按照提示完成安装

步骤2：连接服务器#

打开 GMSSH 应用
点击”添加服务器”按钮
输入服务器 IP 地址、用户名和密码
点击”连接”按钮
等待连接成功

步骤3：开始管理#

连接成功后，你就可以通过可视化界面管理服务器了：

拖拽文件进行上传下载
双击文件进行在线编辑
使用 AI 助手执行运维任务
查看系统资源使用情况

我的使用体验#

使用 GMSSH 后，服务器管理变得非常简单：

可视化操作：不需要记住复杂的命令行，通过界面就能完成大部分操作
AI 智能助手：遇到问题时可以直接问 AI，它会帮你分析和解决
零侵入设计：不需要在服务器上安装任何额外软件
安全可靠：基于 SSH 连接，安全有保障
监控全面：可以实时查看系统资源使用情况

相比之下，之前使用传统的命令行工具时，我需要记住各种命令，而且容易出错，现在通过 GMSSH 的可视化界面，一切都变得简单多了。

适合谁用？#

运维新手：不熟悉命令行操作的新手
服务器管理员：需要管理多台服务器的管理员
开发者：需要经常部署和管理应用的开发者
任何人：需要管理 Linux 服务器的人

项目地址#

如果你对 GMSSH 感兴趣，可以访问它的 GitHub 仓库：https://github.com/GMSSH/GMSSH

官网地址#

你可以直接访问 GMSSH 的官网下载使用：https://www.gmssh.com/

互动时间#

你们平时是如何管理服务器的？使用过 GMSSH 吗？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

NAS 玩家福音！Tugtainer 自动更新容器，告别繁琐操作

2026-03-11T18:31:13.000Z

朋友们！NAS 上的容器更新太麻烦？我找到了解决方案！#

我的nas上部署了太多的容器，有用的没用的好几页，每次镜像更新都会比较苦恼，所以我就想有没有一个软件可以自动更新我的容器镜像？终于找到了一个工具，那就是 Tugtainer，大家有和我一样想法的一起来看看吧

什么是 Tugtainer？#

Tugtainer#

yt-dlp-webui 是一个为 yt-dlp 设计的网页界面，它允许你通过简单的 web UI 从各种平台下载视频和音频。它被设计为自托管的，意味着你可以在自己的服务器或电脑上运行它，更加安全和私密。

为什么选择 Tugtainer？#

1️⃣ 有直观的 Web UI#

这是 Tugtainer 最大的优势！Watchtower 是一个纯命令行工具，没有任何界面，你无法直观地看到哪些容器需要更新，更新状态如何。而 Tugtainer 提供了一个美观的 Web UI，让你可以：

一目了然地看到所有容器的状态
手动触发更新
查看更新历史
配置更新策略

2️⃣ 更灵活的更新策略#

Tugtainer 允许你为每个容器设置不同的更新策略，比如：

自动更新
手动更新
忽略更新

而 Watchtower 只能设置全局的更新策略，无法针对单个容器进行配置。

3️⃣ 通知功能#

Tugtainer 支持通过 Apprise 发送通知，当容器更新完成或失败时，你会收到通知。而 Watchtower 的通知功能相对简单。

4️⃣ 更详细的更新历史#

Tugtainer 会记录详细的更新历史，你可以查看每个容器的更新记录，了解更新时间、版本变化等信息。而 Watchtower 只能通过日志查看更新情况，不够直观。

5️⃣ 支持多服务器管理#

如果你有多个 Docker 服务器，Tugtainer 可以通过代理统一管理，而 Watchtower 只能管理单个服务器上的容器。

如何部署 Tugtainer？#

使用 Docker Compose 部署#

创建 docker-compose.yml 文件
- 在一个空文件夹中创建 docker-compose.yml 文件
- 复制以下内容到文件中：

1
version: '3.8'
2

3
services:
4
  tugtainer:
5
    image: quenary/tugtainer:latest
6
    container_name: tugtainer
7
    restart: unless-stopped
8
    ports:
9
      - "18890:80"
10
    volumes:
11
      - /var/run/docker.sock:/var/run/docker.sock:ro
12
      - ./data:/tugtainer
13
    environment:
14
      - TZ=Asia/Shanghai
15
    networks:
16
      - tugtainer_net
17

18
networks:
19
  tugtainer_net:
20
    driver: bridge

展开收起

启动服务
- 在文件夹目录下执行命令：docker-compose up -d
- 等待服务启动完成
访问 Web UI
- 打开浏览器，访问 http://localhost:3000
- 你将看到 Tugtainer 的 Web 界面

如何使用 Tugtainer？#

1. 查看容器状态#

登录 Tugtainer Web UI
在首页查看所有容器的状态，包括当前版本、可用版本等

2. 手动触发更新#

在容器列表中，找到需要更新的容器
点击 “更新” 按钮
等待更新完成

3. 配置更新策略#

点击容器名称进入详情页
在 “更新策略” 中设置自动更新、手动更新或忽略更新
点击 “保存” 按钮

4. 查看更新历史#

在左侧菜单中点击 “历史”
查看所有容器的更新历史
点击具体更新记录查看详细信息

我的使用体验#

使用 Tugtainer 后，我 NAS 上的容器管理变得非常简单：

一目了然：通过 Web UI 可以清晰地看到所有容器的状态
操作便捷：可以手动触发更新，也可以设置自动更新
灵活配置：可以为每个容器设置不同的更新策略
通知及时：更新完成后会收到通知，不用时刻关注
历史记录：可以查看详细的更新历史，了解容器的版本变化

相比之下，之前使用 Watchtower 时，我只能通过命令行查看日志，无法直观地了解容器状态，也无法针对单个容器设置更新策略，非常不方便。

适合谁用？#

NAS 用户：拥有多个容器需要管理的 NAS 用户
Docker 爱好者：喜欢使用 Docker 部署各种服务的用户
服务器管理员：管理多个 Docker 服务器的管理员
任何人：需要自动更新 Docker 容器的人

项目地址#

Tugtainer：https://github.com/Quenary/tugtainer
Watchtower：https://github.com/containrrr/watchtower

互动时间#

你们平时是如何管理 NAS 上的容器的？使用过 Tugtainer 或 Watchtower 吗？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

TVBox 源聚合神器！一个地址看遍全网资源，还能自动测速去重

2026-03-11T18:31:13.000Z

朋友们！TVBox 源总是失效？这个工具让你的追剧体验更稳定！#

前几天有朋友问我：“小王，TVBox 的源总是失效，有没有什么办法让它更稳定？“，作为一个资深 TVBox 用户，我太懂这种感受了——刚找到一个好用的源，没几天就失效了，又要到处找新源，简直让人崩溃。

今天我要给大家推荐一个超级好用的开源项目——TVBox Source Aggregator，它是一个 TVBox 源聚合器，能将多个配置源合并成一个稳定的聚合地址，还能自动测速筛选、站点级去重，让你的追剧体验更稳定！

这两天我用了之后简直爱不释手，今天就来和大家唠唠这个神奇的工具，看看它是怎么解决 TVBox 源不稳定的问题的。

项目介绍#

TVBox Source Aggregator 是一个专为 TVBox 设计的源聚合工具，它的核心价值在于：将多个 TVBox 配置源合并成一个稳定的聚合地址，自动处理源的问题。

✨ 核心特性#

🚀 多源聚合：添加多个 TVBox 配置 JSON 地址，自动合并为一个
🔍 站点去重：不同源中的相同站点只保留一份，避免重复内容
🧠 Spider JAR 智能分配：自动处理 type<3> 站点的 JAR 依赖冲突
⚡ 测速筛选：自动过滤不可达或高延迟的源，保证流畅体验
💻 管理后台：网页端添加/删除源，触发刷新，操作简单
⏰ 定时更新：每天自动重新聚合，客户端无感知
🛡️ 容错设计：聚合失败时保留上次有效缓存，确保服务不中断

🛠️ 技术栈#

类别	技术/组件	说明
后端	Node.js	核心运行环境
框架	Hono	HTTP 路由框架
存储	SQLite / JSON 文件 / Cloudflare KV	数据存储
部署	Docker / Cloudflare Worker / 本地运行	多种部署方式
语言	TypeScript	类型安全的代码

🎯 应用场景#

家庭观影：在智能电视上使用 TVBox，享受稳定的视频源
个人追剧：在手机上使用 TVBox，随时随地看剧
源管理：集中管理多个 TVBox 源，避免源失效的困扰
技术爱好者：自建服务，掌控自己的观影体验

部署实战#

部署方式一：Docker（推荐）#

对于有服务器或 NAS 的用户，Docker 部署是最方便的方式：

克隆仓库：

Terminal window

1
git clone https://gitee.com/tengxiaobao/tvbox-source-aggregator.git
2
cd tvbox-source-aggregator

配置环境变量：
Terminal window
```
1
cp .env.example .env
```
编辑 .env 文件，至少修改 ADMIN_TOKEN 为你的管理密码
启动容器：
Terminal window
```
1
docker compose up -d
```
访问管理后台：打开 http://你的IP:5678/admin，输入密码登录管理

部署方式二：一键脚本#

适合没有 Docker 但有 Node.js 环境的用户：

克隆仓库：

Terminal window

1
git clone https://gitee.com/tengxiaobao/tvbox-source-aggregator.git
2
cd tvbox-source-aggregator

一键启动：
- Mac 用户：双击 start.command 文件
- Windows 用户：双击 start.bat 文件
- 命令行用户：运行 node scripts/start.js

后台运行（可选）：

Terminal window

1
# 使用 pm2
2
npm install -g pm2
3
pm2 start scripts/start.js --name tvbox

部署方式三：Cloudflare Worker（免费）#

不需要自己的服务器，完全免费：

准备环境：
- Cloudflare 账号（免费）
- Node.js 18+

克隆仓库：

Terminal window

1
git clone https://gitee.com/tengxiaobao/tvbox-source-aggregator.git
2
cd tvbox-source-aggregator
3
npm install

登录 Cloudflare：
Terminal window
```
1
npx wrangler login
```

创建 KV 存储：

Terminal window

1
npx wrangler kv namespace create KV
2
npx wrangler kv namespace create KV --preview

设置密码：

Terminal window

1
# 记得 your-admin-password 改为你自己的密码
2
echo "your-admin-password" | npx wrangler secret put ADMIN_TOKEN

部署：
Terminal window
```
1
npm run deploy
```

自定义域名（推荐）

Workers 默认的 *.workers.dev 域名在部分网络环境下不可直接访问。如果你有托管在 Cloudflare 的域名：

在 Cloudflare DNS 添加记录：AAAA tvbox 100:: （已代理）
取消 wrangler.toml 中 routes 的注释，填入你的域名和 Zone ID

使用指南#

添加源#

登录管理后台：打开 http://你的地址/admin，输入密码
添加源：在输入框中填入 TVBox 配置 JSON URL，点击 Add
管理源：可以删除不需要的源，或点击 Refresh 触发一次聚合

TVBox 配置#

将你的聚合地址填入 TVBox 的接口地址：

1
http://你的地址:5678/

端点说明#

端点	说明
`/`	TVBox 配置 JSON（客户端填这个地址）
`/status`	监控仪表盘页面
`/admin`	管理后台（密码保护）

我的使用感受#

作为一个资深 TVBox 用户，我必须说 TVBox Source Aggregator 彻底改变了我的追剧体验。以前我总是为了源失效而发愁：

要么是刚找到的源没几天就失效了
要么是多个源之间重复内容太多
要么是有些源速度太慢，播放卡顿

现在有了 TVBox Source Aggregator，一切都变得超级简单：

稳定可靠：多个源聚合，一个失效了还有其他的，再也不用担心源失效的问题
自动去重：不同源中的相同站点只保留一份，界面更整洁
智能测速：自动过滤高延迟的源，保证播放流畅
管理方便：网页端管理后台，添加删除源超级简单
多种部署方式：不管是有服务器还是没有服务器，都能找到适合自己的部署方式

前几天我用它部署了一个聚合源，添加了5个不同的 TVBox 源，聚合后的地址非常稳定，播放也很流畅，简直不要太香！

总结#

今天和大家分享了 TVBox Source Aggregator 这个开源项目，它通过聚合多个 TVBox 配置源，解决了 TVBox 源不稳定的问题。无论是自动去重、智能测速还是多种部署方式，都让我们的追剧体验变得更加稳定和流畅。

TVBox Source Aggregator 的核心优势在于：多源聚合提高稳定性、站点去重避免重复内容、Spider JAR 智能分配解决依赖冲突、测速筛选保证流畅体验、管理后台操作简单、定时更新客户端无感知、容错设计确保服务不中断。

无论是家庭观影、个人追剧还是源管理，TVBox Source Aggregator 都能满足你的需求。最重要的是，它完全开源免费，让每个人都能享受稳定的 TVBox 观影体验。

项目资源#

GitHub地址：https://github.com/qq148376839/tvbox-source-aggregator Gitee地址：https://gitee.com/tengxiaobao/tvbox-source-aggregator

觉得项目不错的话，记得给作者点个star支持一下！

项目特色：TVBox 源聚合器，将多个配置源合并成一个稳定的聚合地址，支持自动测速筛选、站点级去重、Spider JAR 智能分配，提供多种部署方式。

互动时间#

你是不是已经跃跃欲试了？赶紧按照文中的步骤部署 TVBox Source Aggregator，体验稳定的 TVBox 观影体验吧！

如果你用了之后有什么有趣的体验，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的开源工具，记得关注我哦！

今天的分享就到这里结束了，我们下一篇文章见。

闲鱼卖家福音！AI自动值守神器，真正拥有“睡后收入”

2026-03-11T18:31:13.000Z

小王发现了一个超好用的闲鱼自动化工具！#

今天我要给大家推荐一个超级神器——Xianyu AutoAgent，它能7×24小时帮你自动值守闲鱼，智能回复消息，甚至还能帮你谈价格，彻底解放你的双手！

什么是 Xianyu AutoAgent？#

Xianyu AutoAgent 是一个专为闲鱼平台打造的AI自动化值守解决方案，基于大模型实现，能实现7×24小时全天候自动化运营，支持智能对话、自动议价等功能。

为什么推荐 Xianyu AutoAgent？#

1️⃣ 7×24小时自动值守#

不管你是在上班、睡觉还是出去玩，Xianyu AutoAgent 都能帮你实时回复买家消息，不错过任何一个潜在客户。

2️⃣ 智能议价功能#

它能根据你设置的价格策略，自动与买家进行议价，既不会让你吃亏，又能提高成交率。

3️⃣ 多场景对话支持#

无论是技术问题、价格问题还是其他咨询，Xianyu AutoAgent 都能应对自如，提供专业的回复。

4️⃣ 人工接管随时切换#

当遇到复杂问题时，你可以随时接管对话，处理完后再交给AI继续值守。

5️⃣ 简单部署，轻松上手#

只需要通过 Docker 部署，配置好相关参数，就能立即开始使用。

前期准备#

在使用 Xianyu AutoAgent 之前，你需要准备以下东西：

1. AI模型密钥#

推荐使用硅基流动（国内访问稳定），注册后系统会自动赠送16元代金卷，足够体验使用了。

注册地址：https://cloud.siliconflow.cn/i/xpMprZk4
注册后进入【控制台】→【密钥】，点击”创建密钥”
复制保存生成的密钥（类似”sk-xxxxxx”的字符串）
记录一下要使用的模型id（类似”deepseek-ai/DeepSeek-V3.2”）

2. 闲鱼Cookie#

浏览器登录闲鱼官网：https://www.goofish.com/
按 F12 打开开发者工具
转到 Network → 刷新页面 → 找到 Cookie
复制完整的 Cookie 字符串备用

部署步骤#

方法一：Docker Compose 部署#

创建目录
- 新建一个文件夹，用于存储配置文件和数据
创建 docker-compose.yml 文件
- 在文件夹中创建 docker-compose.yml 文件
- 复制以下内容到文件中：

1
services:
2
  XianyuAutoAgent:
3
    image: shaxiu/xianyuautoagent:latest
4
    container_name: xianyuautoagent
5
    restart: always
6
    volumes:
7
      - ./data:/app/data
8
      - ./prompts:/app/prompts
9
    environment:
10
      - TZ=Asia/Shanghai
11
      - API_KEY=sk-xxxxxxxxxxxxxx  # 替换为你的硅基流动密钥
12
      - COOKIES_STR=xxxxxxxxxxxxxx  # 替换为你的闲鱼Cookie
13
      - MODEL_BASE_URL=https://api.siliconflow.cn/v1  # 替换为你的模型基础URL
14
      - MODEL_NAME=deepseek-ai/DeepSeek-V3.2 # 替换为你的模型名称
15
      - TOGGLE_KEYWORDS=。  # 切换关键词，用于人工接管
16
      - SIMULATE_HUMAN_TYPING=False  # 模拟人工输入延迟，默认为False，True为开启
17
networks:
18
  xianyu-network:
19
    driver: bridge

展开收起

启动服务
- 在文件夹目录下执行命令：docker-compose up -d
- 等待服务启动完成

方法二：NAS 部署#

如果你的 NAS 支持 Docker，也可以在 NAS 上部署 Xianyu AutoAgent，这样就能24小时稳定运行。

提示词配置#

Xianyu AutoAgent 使用4个提示词模板文件来指导AI回复不同类型的问题：

classify_prompt.txt - 分类提示词，用于识别用户意图
price_prompt.txt - 价格相关提示词，用于回答价格问题
tech_prompt.txt - 技术相关提示词，用于回答技术问题
default_prompt.txt - 默认提示词，用于回答其他类型问题

你可以根据自己的业务需求，修改这些提示词模板，让AI回复更加符合你的风格。

使用体验#

部署完成后，Xianyu AutoAgent 会自动连接到闲鱼的服务器，开始工作。当买家给你发消息时，AI会自动回复，甚至可以帮你谈价格。

实时监控#

你可以通过查看日志，实时监控AI与买家的对话情况，了解AI的表现。

人工接管#

当遇到AI无法处理的复杂问题时，你可以在闲鱼聊天框输入”。“（中文句号），切换到人工模式，处理完后再次输入”。“，切换回AI模式。

常见问题#

Cookie有效期多久？

Cookie存在有效期，因此可能需要一星期（可能更久，以实际为准）重新更新一下cookie，cookie过期后控制台的日志会输出error告诉你是什么问题；
之前cookie过期以后会自动更新续期，但是最近闲鱼加强了风控，因此遇到哎呦喂挤爆了，即为触发风控，需要过滑块更新cookie

可以多账号部署嘛？

直接多开程序即可，复制多个程序文件夹，每个文件夹中的cookie为不同的账号的即可

支持本地大模型嘛？

通过ollama部署模型直接调用即可，.env文件中修改模型名称和模型地址

报错：哎呦喂，挤爆了

解决办法：关闭程序-进入闲鱼网页版-点击消息-过滑块-重新获取cookie，将最新的cookie粘贴到env文件中

适合谁用？#

闲鱼卖家：想要解放双手，提高运营效率
兼职卖家：没有太多时间盯店
多店运营：需要同时管理多个闲鱼账号
新手卖家：不知道如何回复买家问题

项目地址#

如果你对 Xianyu AutoAgent 感兴趣，可以访问它的 GitHub 仓库：https://github.com/shaxiu/XianyuAutoAgent

互动时间#

你们平时在闲鱼卖货时遇到过什么问题？使用 Xianyu AutoAgent 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

音乐爱好者福音！MiMusic 自托管个人音乐服务器，简单自由又强大

2026-03-11T18:31:13.000Z

朋友们！还在为音乐管理发愁？#

今天我要给大家推荐一个超好用的自托管个人音乐服务器——MiMusic，它简单、自由、插件化，支持 6 个平台，让你随时随地享受自己的音乐！

什么是 MiMusic？#

MiMusic 是一个自托管个人音乐服务器，专注于提供简单、自由的音乐管理和播放体验。它由 Go 语言编写，轻量高效，适合在 NAS、树莓派等低功耗设备上运行。

为什么推荐 MiMusic？#

1️⃣ 本地音乐管理#

扫描本地目录，自动提取 MP3/FLAC/WAV/APE/OGG/M4A 等格式的封面和元数据，让你的音乐库井井有条。

2️⃣ WASM 插件体系#

WebAssembly 沙箱运行，支持多种扩展插件，功能无限扩展。

🧩 插件合集#

MiMusic 提供了丰富的插件，让你的音乐服务器功能更加强大：

1. 音乐标签刮削#

版本：2026.4.6 描述：从其他平台提取歌曲元数据（标题、专辑、艺术家、歌词、封面）作者：MiMusic Team 下载地址：

1
https://github.com/mimusic-org/mimusic-plugin-musictag/releases/download/v2026.4.6/musictag.wasm.zip

这个插件可以自动为你的音乐文件添加完整的元数据，让你的音乐库更加规范和美观。

2. Cloudflared 隧道#

版本：2026.4.10 描述：通过 Cloudflare Tunnel 将本地 MiMusic 服务暴露到公网，支持 cloudflared 的下载和管理作者：MiMusic Team 下载地址：

1
https://github.com/mimusic-org/mimusic-plugin-cloudflared/releases/download/v2026.4.10/cloudflared.wasm.zip

有了这个插件，你可以在任何地方访问你的音乐服务器，无需复杂的网络配置。

3. 小米音箱插件#

版本：2026.4.10 描述：提供小米账号登录和小爱音箱控制功能，支持多账号管理作者：MiMusic Team 下载地址：

1
https://github.com/mimusic-org/plugins/releases/download/plugin-xiaomi-2026.4.10/xiaomi.wasm.zip

通过这个插件，你可以将 MiMusic 与你的小米音箱集成，用语音控制音乐播放。

4. 洛雪音源#

版本：2026.4.10 描述：管理洛雪音源，搜索和导入网络歌曲作者：MiMusic Team 下载地址：

1
https://github.com/mimusic-org/mimusic-plugin-lxmusic/releases/download/v2026.4.10/lxmusic.wasm.zip

这个插件让你可以搜索和导入网络歌曲，丰富你的音乐库。

如何安装插件#

访问 MiMusic Web 界面
进入 “插件管理” 页面
点击 “上传插件” 按钮
选择下载好的插件文件（.wasm.zip 格式）
等待插件安装完成
启用插件并配置相关参数

3️⃣ 跨平台客户端#

Flutter 客户端支持 Android、iOS、macOS、Windows、Linux、Web 六端，随时随地听音乐。

4️⃣ Web 界面#

完整版内置 Web 前端，开箱即用，无需额外配置。

6️⃣ 网络歌曲 & 电台#

支持添加网络歌曲和网络电台，丰富你的音乐来源。

8️⃣ 轻量高效#

Go 编写，CGO-free，无外部依赖，适合 NAS / 树莓派等低功耗设备。

MiMusic 版本说明#

MiMusic 提供两种版本，满足不同使用场景：

版本	说明	适用场景
完整版-full	包含 Web 前端，开箱即用	推荐初次使用，访问服务地址即可看到 Web 界面
精简版	不包含 Web 前端，体积更小	配合 Flutter 桌面/移动客户端，或前后端分离部署

推荐：初次使用建议下载完整版（-full），开箱即用，无需额外配置前端。

如何部署 MiMusic？#

方式一：直接运行二进制文件#

Linux / macOS

Terminal window

1
# 1️⃣ 下载对应平台的二进制文件（推荐完整版）
2
# 例如 Linux x86_64 完整版:
3
wget https://github.com/mimusic-org/mimusic/releases/latest/download/mimusic-linux-amd64-full
4

5
# 2️⃣ 添加执行权限
6
chmod +x mimusic-linux-amd64-full
7

8
# 3️⃣ 创建必要目录
9
mkdir -p music data
10

11
# 4️⃣ 运行
12
./mimusic-linux-amd64-full

Windows

Terminal window

1
# 1️⃣ 下载对应平台的二进制文件（推荐完整版）
2
# 例如 Windows x86_64 完整版: mimusic-windows-amd64-full.exe
3

4
# 2️⃣ 创建必要目录
5
mkdir music
6
mkdir data
7

8
# 3️⃣ 运行
9
.imusic-windows-amd64-full.exe

二进制部署

方式二：Docker 部署#

从 Docker Hub 拉取（推荐）

Terminal window展开收起

1
# 🌟 拉取完整版镜像（推荐，包含 Web 前端）
2
version: '3.8'
3

4
services:
5
  mimusic:
6
    image: hanxi/mimusic:full
7
    container_name: mimusic
8
    restart: always
9
    ports:
10
      - "58091:58091"
11
    volumes:
12
      # 音乐文件目录（你可以改成自己的真实路径）
13
      - ./music:/app/music
14
      # 数据配置目录
15
      - ./data:/app/data
16
    environment:
17
      - ADMIN_USERNAME=admin
18
      - ADMIN_PASSWORD=your_secure_password  # 记得改成你自己的密码

展开收起

配置说明#

环境变量

变量名	说明	默认值
ADMIN_USERNAME	管理员用户名	admin
ADMIN_PASSWORD	管理员密码	admin
LISTEN_PORT	服务端口	58091
MUSIC_PATH	音乐文件路径	./music
DATA_PATH	数据存储路径	./data

访问服务#

服务启动后，通过以下方式访问：

Web 界面：http://服务器IP:58091

API 文档：http://服务器IP:58091/api/docs

默认账号：admin / admin（首次登录后请修改密码）

上传音乐#

将你的音乐文件复制到音乐目录（默认为 ./music），MiMusic 会自动扫描并添加到音乐库。

Terminal window

1
# 上传音乐文件到服务器
2
scp -r /path/to/your/music/* root@服务器IP:/path/to/music/

测试验证#

登录系统

使用默认账号登录 MiMusic Web 界面。

浏览音乐库

查看自动扫描的音乐文件。

多设备测试

在不同设备上测试 MiMusic 的跨平台功能。

移动端#

平板#

通过测试来看，MiMusic 的功能非常强大，部署也很简单。呵呵是不是很实用？

我的使用体验#

前几天我试用了 MiMusic，体验真的非常好：

部署简单：无论是直接运行二进制文件还是 Docker 部署，都非常方便
界面美观：Web 界面设计现代简约，操作直观
功能丰富：本地音乐管理、网络歌曲、电台等功能应有尽有
跨平台：在电脑、手机、平板上都能无缝使用
轻量高效：在我的树莓派上运行流畅，占用资源少

最重要的是，MiMusic 让我完全掌控自己的音乐库，不用依赖第三方音乐平台，这一点真的很贴心！

适合谁用？#

音乐爱好者：拥有大量本地音乐，需要统一管理的人
NAS 用户：在 NAS 上搭建个人音乐服务器的人
树莓派玩家：利用树莓派构建家庭媒体中心的人
隐私关注者：不想将音乐数据存储在第三方平台的人
开发者：想要定制自己的音乐服务器的人

项目资源#

如果你对 MiMusic 感兴趣，可以访问以下资源：

GitHub地址: https://github.com/mimusic-org/mimusic

客户端下载地址: https://github.com/mimusic-org/frontend

觉得项目不错可以点个赞。

官方文档: https://mimusic.hanxi.cc/

在线演示：https://mimusic.hanxi.cc/（账号/密码：admin）

互动时间#

你们平时是如何管理自己的音乐的？使用 MiMusic 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

GitHub热门项目！Voicebox，开源语音合成的终极解决方案

2026-03-11T18:31:13.000Z

朋友们！AI语音合成太贵？试试这个开源神器，完全免费还保护隐私！#

今天我要给大家推荐一个超级好用的语音合成工具——Voicebox，它是一个本地优先的开源语音克隆工作室，完全免费，在你的电脑上本地运行，保护隐私的同时，提供专业级的语音合成能力！

这两天这个项目在技术圈子里特别火，今天我就来和大家唠唠这个神奇的工具，看看它是怎么让我们这些普通用户也能拥有专业级语音合成能力的。

项目介绍#

Voicebox 是一个完全开源的语音合成工作室，它的核心价值在于：在你的本地设备上克隆声音、生成多语言语音、应用专业音频效果，并且完全保护你的隐私。

✨ 核心特性#

🚀 本地优先：所有模型和语音数据都在你的电脑上运行，完全保护隐私
🎯 多引擎支持：集成5个TTS引擎（Qwen3-TTS、LuxTTS、Chatterbox Multilingual、Chatterbox Turbo、HumeAI TADA）
🌍 多语言覆盖：支持23种语言，从英语到阿拉伯语、日语、印地语、斯瓦希里语等
🎨 专业音频效果：8种后期处理效果（音高调整、混响、延迟、合唱、压缩、滤波器等）
😊 情感表达：支持 [laugh]、[sigh]、[gasp] 等情感标签（Chatterbox Turbo引擎）
📜 无限长度：自动分块处理，支持超长文本生成
🎬 故事编辑器：多音轨时间线编辑器，适合对话、播客和叙事内容
🔌 API支持：REST API便于集成到自己的项目中
⚡ 原生性能：基于Tauri（Rust）构建，不是Electron，性能更优
🌐 跨平台：支持macOS（MLX/Metal）、Windows（CUDA）、Linux、AMD ROCm、Intel Arc、Docker

🛠️ 技术栈#

类别	技术/组件	说明
前端	Tauri (Rust)	跨平台桌面应用框架，性能优于Electron
后端	Python	语音合成引擎和API服务
TTS引擎	Qwen3-TTS	高质量多语言克隆，支持 delivery instructions
TTS引擎	LuxTTS	轻量级（~1GB显存），48kHz输出，CPU上150x实时速度
TTS引擎	Chatterbox Multilingual	支持23种语言，覆盖面最广
TTS引擎	Chatterbox Turbo	快速350M模型，支持情感/声音标签
TTS引擎	TADA	HumeAI语音语言模型，700s+连贯音频
音频处理	Spotify pedalboard	专业音频效果处理库
转录	Whisper	自动语音转文字

🎯 应用场景#

内容创作：视频配音、有声书制作、播客生成
辅助工具：为视障人士提供语音导航、文档朗读
游戏开发：角色语音、NPC对话生成
教育领域：多语言教学内容、有声教材
商业应用：客服语音、产品介绍、营销内容

实战体验#

环境准备#

用Voicebox真的超级简单，不需要复杂的配置，只要你的电脑满足基本要求：

Windows：支持CUDA的NVIDIA显卡
macOS：Apple Silicon或Intel处理器
Linux：支持AMD ROCm或Intel Arc

项目下载#

首先，咱们去GitHub看看这个宝藏仓库：https://github.com/jamiepine/voicebox

根据你的操作系统选择对应的下载链接：

平台	下载方式
macOS (Apple Silicon)	下载DMG
macOS (Intel)	下载DMG
Windows	下载MSI
Docker	`docker compose up`
Linux	源码编译（见官方文档）

安装体验#

下载完成后，按照常规软件安装步骤进行安装。安装过程非常简单，一路点击下一步即可。

安装完成后，启动Voicebox，第一次运行时会自动下载所需的模型文件。

Docker部署#

除了直接安装，Voicebox还支持通过Docker部署，这对于服务器环境或需要隔离运行的场景非常方便：

环境准备：确保你的系统已安装Docker和Docker Compose
- Windows：下载并安装Docker Desktop
- macOS：下载并安装Docker Desktop
- Linux：使用包管理器安装Docker

获取项目：克隆Voicebox仓库

1
 services:
2
     voicebox:
3
         build: .
4
         container_name: voicebox
5
         restart: unless-stopped
6

7
         ports:
8
         # Bind to localhost only for security
9
         - "127.0.0.1:17493:17493"
10

11
         volumes:
12
         # Bind-mount for generated audio (customize the host path as needed)
13
         # Host side:      ./output/
14
         # Container side: /app/data/generations/
15
         - ./output:/app/data/generations
16

17
         # Named volume for profiles, DB, cache (persists across container restarts)
18
         - voicebox-data:/app/data
19

20
         # HuggingFace model cache (so models aren't re-downloaded on rebuild)
21
         - huggingface-cache:/home/voicebox/.cache/huggingface
22

23
         environment:
24
         - LOG_LEVEL=info
25

26
         networks:
27
         - voicebox-net
28

29
         deploy:
30
         resources:
31
             limits:
32
             cpus: '4'
33
             memory: 8G
34
     networks:
35
     voicebox-net:
36
         driver: bridge
37

38
     volumes:
39
     voicebox-data:
40
     huggingface-cache:

展开收起

启动容器：使用Docker Compose启动
Terminal window
```
1
docker compose up -d
```
访问应用：启动完成后，在浏览器中访问 http://localhost:17493

声音克隆#

Voicebox最强大的功能之一就是声音克隆，只需几秒钟的音频样本就能创建属于你自己的语音模型。

创建语音配置文件：点击”Create Profile”按钮
上传音频样本：可以上传多个音频文件或直接在应用内录制
等待处理：系统会自动分析音频并创建语音模型
测试生成：输入文本，选择刚创建的语音配置文件进行测试

多语言生成#

Voicebox支持23种语言的语音生成，让你轻松创建多语言内容：

选择语言：在生成界面选择目标语言
输入文本：用对应语言输入文本内容
选择引擎：不同引擎对不同语言有不同的优势
生成语音：点击生成按钮，等待结果

音频效果处理#

Voicebox内置8种专业音频效果，让你的语音更加专业：

选择效果：在效果面板选择需要的效果
调整参数：根据需要调整效果参数
实时预览：调整后可以实时预览效果
应用效果：点击应用按钮，生成带有效果的语音

故事编辑器#

对于需要多角色对话的场景，Voicebox的故事编辑器非常实用：

创建新项目：在故事编辑器中创建新项目
添加音轨：为每个角色创建独立音轨
输入文本：为每个音轨输入对应的文本
调整时间线：拖动调整各部分的时间位置
预览和导出：预览整体效果后导出最终音频

总结#

今天和大家分享了Voicebox这个开源语音合成的宝藏项目，它用”本地优先 + 多引擎集成”的方式，完美解决了传统语音合成的诸多痛点。通过简单的安装和操作，我们这些普通用户也能轻松获得专业级的语音合成能力。

Voicebox的核心优势在于：本地运行保护隐私、多引擎支持满足不同需求、多语言覆盖拓展应用场景、专业音频效果提升品质、情感表达增加自然度、无限长度支持长内容、故事编辑器简化多角色内容创作。

无论是内容创作者、教育工作者、游戏开发者还是普通用户，Voicebox都能为你提供强大而灵活的语音合成解决方案。最重要的是，它完全开源免费，让每个人都能享受AI语音技术的便利。

项目资源#

GitHub地址：https://github.com/jamiepine/voicebox

觉得项目不错的话，记得给作者点个star支持一下！

项目特色：本地优先的开源语音合成工作室，集成5个TTS引擎，支持23种语言，提供专业音频效果，保护隐私，完全免费。

互动时间#

你是不是已经跃跃欲试了？赶紧去GitHub下载适合你系统的版本，试试这个神奇的语音合成工具吧！

如果你用了之后有什么有趣的体验，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的开源工具，记得关注我哦！

今天的分享就到这里结束了，我们下一篇文章见。

你的NAS除了存小姐姐还能干啥？Docker部署「闲鱼管理系统」轻松赚奶茶钱！！

2026-03-11T18:31:13.000Z

嘿，各位NAS玩家！机器折腾好了，电影下满了，然后呢？是不是又开始觉得，这台24小时开机的“小电脑”，除了存片儿和偶尔同步下文件，好像……还有点“大材小用”？折腾的心有点冷却了？

今天，我给你指条“野路子”——让你家的飞牛NAS，变身一台24小时在线的“自动售货机”，帮你卖点虚拟商品，赚点零花钱！

啥是虚拟商品？比如：

你整理的软件安装包、素材资源（放网盘，卖链接）
你开发的小工具、脚本（卖卡密授权）
你买的付费教程、课程（转卖观看权）
各类游戏激活码、会员账号等等

这些东西，成本极低，几乎不用操心库存和物流。最大的痛点是什么？需要人工盯着闲鱼，回复买家的咨询，手动发卡密或链接，烦都烦死了！

如果有一个工具，能自动回复买家问题，收到付款后自动发货，甚至能智能聊天……那不就解放了？

还真有！而且，它就能完美运行在你的飞牛NAS上！

详细介绍#

今天的主角，「闲鱼自动回复与发货系统」

你可以把它理解成一个 “数字店员” ，专门帮你打理闲鱼店铺。它的本事可大了：

智能自动回复：买家问“在吗？”“怎么用？”“有教程吗？”，它都能根据你设置的关键词自动回答，还能接入AI（比如ChatGPT），进行有上下文的理解式聊天！

多账号管理：支持扫码登录、账户密码登录、Cookie方式登录。你手头有几个闲鱼号？它能同时管！数据完全隔离，安全得很。

卡卷管理：支持扫码登录、账户密码登录、Cookie方式登录。

全自动发货：买家一旦付款，系统立刻触发发货规则。可以自动发送网盘链接、卡密文本，甚至调用API生成卡密，完全不用你动手。

自动确认发货：发货后，还能自动调用闲鱼官方接口，帮你点击“确认发货”，流程一气呵成。
多种通知渠道：重要消息不遗漏！

商品与数据管理：自动收集上架的商品，管理海量的关键词回复库，所有操作都有日志，清清楚楚。

说白了，你只需要：1. 上架商品。2. 设置好回复话术和发货规则。剩下的事情，就交给NAS里的这个“数字店员”吧！你该上班上班，该睡觉睡觉，钱悄悄地就进来了。

Docker Compose 一键部署#

部署过程依然是熟悉的“抄作业”环节，我们主打一个“复制粘贴就能用”。

第一步：创建它的“小单间”

在你的NAS上，比如在 docker 文件夹里
新建一个 xianyu目录。

第二步：编写 docker-compose

打开飞牛桌面上的Docker界面 -> Compose
写一个项目名称，选择储存路径

（例如你之前创建的目录/vol1/1000/docker/xianyu）

创建 docker-compose.yml 文件，把下面的“咒语”复制粘贴进去

1
services:
2
  xianyu:
3
    image: crpi-ewihweek11p6l2rf.cn-shanghai.personal.cr.aliyuncs.com/price_ma/xianyu-replay-fixed:latest
4
    container_name: xianyu
5
    restart: unless-stopped
6
    ports:
7
      - "3351:8080"  # 左侧3351端口可修改
8
    volumes:
9
      - ./data:/app/data

第三步：启动！！

启动 -> 自动拉取镜像并构建坐等完成。
打开浏览器，访问：http://你的飞牛NAS IP<3351>
默认用户名：admin
默认密码：admin123

登录后，别慌，咱们一步步来设置。

第一环：绑定你的闲鱼账号

在系统里，找到“闲鱼账号管理”，点击“添加账号”。
这时会弹出一个二维码。注意！请务必使用闲鱼APP（不是淘宝APP）扫码登录！
扫码后，手机上确认登录。系统就成功绑定你的闲鱼账号了。可以绑定多个哦！

第二环：设置“自动回复”

通用关键词：在“关键词回复”设置里，添加一些通用问答。
比如：
关键词： → 回复：
关键词： → 回复：
关键词： → 回复：
商品专用回复：针对某个具体商品（比如你卖的“XX软件”），可以设置更精准的回复。优先级最高。
AI智能回复（高阶玩法）：如果你有OpenAI的API密钥，可以开启这个功能。店员就能像真人一样，理解复杂的上下文问题，非常强大。

第三环：设置“自动发货”

在“自动发货规则”里，点击“创建规则”。
匹配商品：可以按商品标题关键词匹配，也可以选择具体商品。
发货方式：
文本内容：最简单，直接填上你的网盘链接和提取码。
卡密文件：如果你有一批卡密（比如，），可以上传一个txt文件，每行一个。系统会自动按顺序发送，并且标记已使用，防止重复。
**API调用：**最灵活，可以对接你自己的发卡网站API，实时生成卡密。
触发条件：一定要勾选 “付款消息”！这样买家一付款，立刻触发发货。
延时发货：可以设置几秒到几分钟的延迟，显得更“真人”一点。

第四环：测试！测试！测试！

自己用小号，在闲鱼上给自己的商品发消息、下单付款，看看整个流程是否顺畅：自动回复了吗？付款后自动发货了吗？发货内容正确吗？

小白福利！这个神器让你轻松下载全网视频，再也不用为会员发愁了

2026-03-11T18:31:13.000Z

朋友们！想下载视频却找不到好用的工具？试试这个免费开源的神器！#

前几天有朋友问我：“小王，有没有什么简单的方法可以下载网上的视频？“，作为一个经常需要保存视频资料的人，我太懂这种感受了——要么是网站不让下载，要么是各种下载工具操作复杂，要么是限速严重，简直让人崩溃。

今天我要给大家推荐一个超级好用的视频下载工具——MeTube，它是一个免费开源的视频下载平台，操作超级简单，支持下载 YouTube 和几十个其他网站的视频，而且完全免费！

这两天我用了之后简直爱不释手，今天就来和大家唠唠这个神奇的工具，看看它是怎么让我们这些小白也能轻松下载视频的。

项目介绍#

MeTube 是一个基于 Web 的视频下载工具，它的核心价值在于：让视频下载变得超级简单，任何人都能轻松上手。

✨ 核心特性#

🚀 操作简单：基于网页界面，不用安装复杂软件，打开浏览器就能用
🌐 支持多网站：不仅支持 YouTube，还支持几十个其他视频网站
📋 播放列表下载：支持整个播放列表批量下载，不用一个个点
🎯 多种格式选择：支持选择不同质量和格式，满足不同需求
🐳 容器化部署：支持 Docker 运行，安装超级方便
🔧 自定义配置：可以设置下载模式、文件命名规则等
📱 跨平台：在任何支持现代浏览器的设备上都能使用
💾 本地存储：下载的视频保存在自己的设备上，完全掌控
🔒 隐私保护：不需要登录账号，保护个人隐私
💰 完全免费：开源项目，没有任何隐藏费用

🎯 应用场景#

学习资料：下载在线课程、教程视频，离线观看
娱乐休闲：下载电影、电视剧、综艺节目，随时观看
素材收集：下载视频素材，用于自己的创作
备份存档：备份重要的视频内容，防止失效
旅行途中：提前下载视频，在没有网络的地方观看

实战体验#

环境准备#

用 MeTube 真的超级简单，只需要一点小准备：

有网络的电脑：任何能上网的电脑都行
Docker：如果用 Docker 部署的话，需要安装 Docker

Docker 部署#

对于小白来说，Docker 部署是最方便的方式：

安装 Docker：如果还没安装 Docker，可以去官网下载 Docker Desktop 并安装
启动容器：打开命令行，输入以下命令
Terminal window
```
1
services:
```

metube: image: ghcr.io/alexta69/metube container_name: metube restart: unless-stopped ports: - “8081<8081>” volumes: - /path/to/downloads:/downloads

1
（把 `/path/to/downloads` 换成你想保存视频的文件夹）
2
3. **访问应用**：打开浏览器，访问 `http://localhost:8081`
3

4
![](https://gcore.jsdelivr.net/gh/wangbin-blog/pic-resources@main/2026/04/f425353cb4f64a2f9b22d53cbb254559screenshot.gif)
5

6
### 下载视频
7

8
下载视频的步骤超级简单，一看就会：
9

10
1. **复制链接**：从视频网站复制视频链接
11
2. **粘贴链接**：在 MeTube 网页的输入框中粘贴链接
12
3. **选择选项**：选择你想要的视频质量和格式
13
4. **开始下载**：点击下载按钮，等待下载完成
14
5. **查看结果**：下载完成后，在下载文件夹中找到视频
15

16
### 播放列表下载
17

18
如果你想下载整个播放列表，步骤也差不多：
19

20
1. **复制播放列表链接**：从视频网站复制整个播放列表的链接
21
2. **粘贴链接**：在 MeTube 网页的输入框中粘贴链接
22
3. **选择选项**：选择你想要的视频质量和格式
23
4. **开始下载**：点击下载按钮，MeTube 会自动下载整个播放列表
24

25
## 我的使用感受
26

27
作为一个技术小白，我必须说 MeTube 彻底改变了我下载视频的方式。以前我总是为了下载视频而发愁：
28

29
- 要么是网站的下载按钮要付费
30
- 要么是各种下载软件操作复杂，根本不会用
31
- 要么是下载速度慢得要死，等半天才能下完
32

33
现在有了 MeTube，一切都变得超级简单：
34

35
1. **操作简单**：打开网页，粘贴链接，点击下载，就这么简单
36
2. **速度快**：下载速度超级快，比我以前用的工具快多了
37
3. **批量下载**：播放列表一键下载，不用一个个点，省了好多时间
38
4. **格式多样**：可以选择不同质量和格式，满足不同需求
39
5. **完全免费**：没有任何费用，想下多少下多少
40

41
前几天我用它下载了一个学习课程的整个播放列表，以前要一个个下载，现在一键搞定，简直不要太方便！
42

43
## 项目资源
44

45
**GitHub地址**：https://github.com/alexta69/metube
46

47
觉得项目不错的话，记得给作者点个star支持一下！
48

49
**项目特色**：免费开源的视频下载平台，基于 Web 界面，支持多网站下载，支持播放列表批量下载，操作简单，完全免费。
50

51
## 互动时间
52

53
你是不是已经跃跃欲试了？赶紧按照文中的步骤部署 MeTube，试试这个神奇的视频下载工具吧！
54

55
如果你用了之后有什么有趣的体验，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的开源工具，记得关注我哦！
56

57
今天的分享就到这里结束了，我们下一篇文章见。

展开收起

哇！这个免费工具能转换1000+种文件格式，还能自己部署超安全

2026-03-11T18:31:13.000Z

朋友们！还在为文件格式转换发愁吗？这个神器帮你搞定一切！#

前几天有朋友给我发消息：“小王，你知道有什么好用的文件转换工具吗？我想把视频转成GIF，试了好几个在线工具要么限速要么要会员，太麻烦了！”

作为一个经常和各种文件打交道的人，我太懂这种感受了——想转个文件吧，要么是在线工具慢得要死，要么是格式支持不全，要么是担心文件隐私问题，简直让人崩溃。

不过最近我发现了一个超级好用的工具，必须要分享给大家——ConvertX！这是一个可以自己部署的在线文件转换器，支持1000多种格式，完全免费，最重要的是文件都在自己服务器上处理，隐私超安全！

这两天我用了之后简直爱到不行，今天就来和大家聊聊这个神器，看看它是怎么解决文件转换难题的。

这是个什么工具？#

简单来说，ConvertX就是一个全能的文件转换工厂，你可以把它部署在自己的电脑或服务器上，然后通过浏览器访问，就能转换各种类型的文件。

想象一下，不管是视频转音频、图片改格式、文档互转，还是电子书转换，都能在一个地方搞定，而且完全免费，不用看广告，也不用担心文件被上传到别人的服务器。

它有什么特别的？#

格式超级多：支持1000多种格式，从常见的MP4、JPG、PDF，到冷门的专业格式，几乎都能搞定
批量转换：一次上传多个文件，一起转换，省时间又方便
自己部署：文件在本地服务器处理，隐私有保障，不用担心敏感文件泄露
操作简单：网页界面一目了然，不用安装任何软件，打开浏览器就能用
多账户支持：如果和家人朋友一起用，每个人都可以有自己的账户
历史记录：随时查看之前的转换记录，方便管理
自动清理：可以设置自动删除旧文件，不会占满存储空间

能转换哪些类型的文件？#

视频：MP4、AVI、MKV、WebM等各种视频格式互转
图片：JPG、PNG、GIF、SVG等图片格式转换
文档：Word、Excel、PDF、PPT等办公文档互转
电子书：EPUB、MOBI、PDF等电子书格式转换
3D文件：各种3D模型格式转换
其他：还有很多专业格式，比如LaTeX、数据文件等

怎么部署使用？#

最简单的方法：Docker部署#

如果你有Docker，部署超级简单，就像装个普通软件一样：

创建配置文件：在电脑上新建一个文件夹，比如叫convertx，然后在里面创建一个叫docker-compose.yml的文件，内容如下：

1
services:
2
  convertx:
3
    image: ghcr.io/c4illin/convertx
4
    container_name: convertx
5
    restart: unless-stopped
6
    ports:
7
      - "3000:3000"
8
    environment:
9
      - JWT_SECRET=随便写个长一点的密码
10
    volumes:
11
      - ./data:/app/data

启动服务：打开命令行，进入刚才创建的文件夹，运行：
Terminal window
```
1
docker compose up -d
```
开始使用：打开浏览器，访问 http://localhost:3000，第一次访问会让你创建账户，设置个密码就好

没有Docker怎么办？#

如果你没有Docker，也可以直接运行：

安装Bun：先去 bun.sh 下载并安装Bun（这是一个现代的JavaScript运行时）
下载代码：运行 git clone https://github.com/C4illin/ConvertX.git，然后进入文件夹
安装依赖：运行 bun install
启动服务：运行 bun run dev

怎么用它转换文件？#

登录：打开 http://localhost:3000，输入你创建的账户密码
上传文件：点击上传按钮，选择要转换的文件（可以一次选多个）
选择格式：在下拉菜单里选择你想要的目标格式
开始转换：点击转换按钮，等一会儿就好了
下载文件：转换完成后，点击下载按钮就能拿到转换后的文件

我的使用体验#

作为一个经常需要处理各种文件的人，我必须说ConvertX真的改变了我的工作方式。

以前我转换文件的流程是这样的：

想转视频，找在线工具，结果限速，大文件要等半天
想转图片，用PS太麻烦，在线工具又担心画质
想转文档，要么用付费软件，要么担心格式错乱
最头疼的是，有些敏感文件根本不敢上传到在线服务

现在有了ConvertX，一切都变得超级简单：

想转什么转什么：不管是视频、图片还是文档，一个工具全搞定
速度超级快：在自己的服务器上处理，速度取决于自己的硬件，比在线工具快多了
质量有保证：用的都是专业转换引擎，转换效果特别好
隐私超安全：文件从来不出本地服务器，敏感文件也不用担心
操作超简单：网页界面一目了然，我妈都能学会用

前几天我用它把一个1GB的视频转换成GIF，只用了几分钟，效果还特别好，简直不要太香！

总结一下#

ConvertX真的是一个超级实用的工具，它解决了我们在文件转换中遇到的几乎所有问题：

不用再为限速、会员费发愁
不用担心格式支持不全
不用害怕文件隐私泄露
操作简单，谁都能学会

最重要的是，它完全免费，开源，你想怎么用就怎么用。

不管你是学生、上班族，还是技术爱好者，只要你经常需要转换文件，ConvertX都能帮你节省大量时间和精力。

项目地址#

GitHub：https://github.com/C4illin/ConvertX

觉得好用的话，记得给作者点个star支持一下！

互动时间#

你是不是已经迫不及待想试试了？赶紧按照文中的步骤部署一个ConvertX，体验一下全能文件转换的乐趣吧！

如果你用了之后有什么有趣的体验，或者遇到了什么问题，欢迎在评论区和我交流。我会定期分享更多好用的开源工具，记得关注我哦！

今天的分享就到这里，我们下一篇文章见～

docker 离线安装（分步法&一键法）

2026-03-11T18:31:13.000Z

原文：https://www.cnblogs.com/505donkey/p/18151705

一、安装环境#

操作系统：Centos7.99 内核版本：3.10.0-1160.el7.x86_64 安装用户：root

二、docker 离线安装#

1. 下载压缩包#

官网下载地址：https://download.docker.com/linux/static/stable/x86_64/

这里默认选择最新版本（28.1.1）

2. 上传压缩包并解压#

Terminal window

1
tar zxvf docker-28.1.1.tgz

3. 配置docker命令#

将解压后的docker命令拷贝到 /usr/bin/ 下。

1
cp docker/\* /usr/bin/

4. 创建启动单元配置#

创建启动单元配置 /etc/systemd/system/docker.service，配置示例如下。

如果有需要，也可以在ExecStart=/usr/bin/dockerd后面加命令行参数，比如我想指定--data-root=/data/docker

1
[Unit]
2
Description=Docker Application Container Engine
3
Documentation=https://docs.docker.com
4
After=network-online.target firewalld.service
5
Wants=network-online.target
6

7
[Service]
8
Type=notify
9
ExecStart=/usr/bin/dockerd
10
ExecReload=/bin/kill -s HUP $MAINPID
11
LimitNOFILE=infinity
12
LimitNPROC=infinity
13
TimeoutStartSec=0
14
Delegate=yes
15
KillMode=process
16
Restart=on-failure
17
StartLimitBurst=3
18
StartLimitInterval=60s
19

20
[Install]
21
WantedBy=multi-user.target

展开收起

5. 给启动配置赋权#

1
# 给启动配置添加执行权限
2
chmod +x /etc/systemd/system/docker.service
3
# 重载单元服务配置
4
systemctl daemon -reload

6. 启动docker#

1
# 添加 docker 开机自启
2
systemctl enable docker
3
# 启动 docker
4
systemctl start docker

7. 安装验证#

1
docker -v

三、一键安装法#

如果您觉得上边的步骤繁琐，也可以用下边的办法，一键安装docker。

3.1 制作docker.service文件#

在docker-18.06.3-ce.tgz同目录下，创建docker.service，打开编辑文件，文件内容与2.4节完全一样，此处不再赘述。

3.2 制作一键安装脚本#

1
touch install.sh

打开编辑install.sh，将以下内容复制到install.sh，保存退出。

1
#!/bin/sh
2

3
echo '解压tar包'
4
tar -xvf $1
5
echo '将docker目录下所有文件复制到/usr/bin目录'
6
cp docker/* /usr/bin
7
echo '将docker.service 复制到/etc/systemd/system/目录'
8
cp docker.service /etc/systemd/system/
9
echo '添加文件可执行权限'
10
chmod +x /etc/systemd/system/docker.service
11
echo '重新加载配置文件'
12
systemctl daemon-reload
13
echo '启动docker'
14
systemctl start docker
15
echo '设置开机自启'
16
systemctl enable docker.service
17
echo 'docker安装成功'
18
docker -v

展开收起

3.3 制作一键卸载脚本#

Touch uninstall.sh，将以下内容复制到uninstall.sh，保存退出。

1
#!/bin/sh
2
echo '停止docker'
3
systemctl stop docker
4
echo '删除docker.service'
5
rm -f /etc/systemd/system/docker.service
6
echo '删除docker文件'
7
rm -rf /usr/bin/docker*
8
echo '重新加载配置文件'
9
systemctl daemon-reload
10
echo '卸载成功'

3.4 安装docker#

此时docker-18.06.3-ce.tgz同目录下，还有上边创建的docker.service，install.sh，uninstall.sh这3个文件：

分别给install.sh和uninstall.sh赋予可执行权限。

1
chmod +x install.sh
2
chmod +x uninstall.sh

开始安装

1
sh install.sh docker-18.06.3-ce.tgz

验证安装

1
docker -v

四、docker-compose 离线安装#

1. 下载压缩包#

官方下载地址：https://github.com/docker/compose/releases

根据实际部署系统版本选择，例如 docker-compose-linux-x86_64，这里下载下来就是一个可执行文件。

2. 将下载文件移动到docker命令所在目录下#

1
# 查看 docker 命令位置，这里为 /usr/bin
2
which docker
3

4
# 移动并重命名
5
mv docker-compose-Linux-x86_64 /usr/bin/docker-compose

3. 赋予执行权限#

1
chmod +x /usr/bin/docker-compose

4. 安装验证#

1
docker-compose -v

MediaMaster：家庭影音一条龙，使用零门槛

2026-03-11T18:31:13.000Z

📖 详细介绍#

🎬 MediaMaster V2[1] 是一个开箱即用的影视自动化订阅管理系统。它基于 Python 构建，支持X86_64、ARM64架构，支持多站点资源订阅、自动化下载、媒体库管理，让你可以轻松管理和享受个人媒体内容。

✨ 核心亮点#

• 🎯 多站点支持：集成多个资源站，部分站点无需PT账号即可使用。
• 🤖 自动化订阅管理：通过 Docker 联动实现影视剧集的自动搜索与下载。
• 💾 下载器兼容性强：支持迅雷、qBittorrent、Transmission 等主流下载器。
• 🔗 软/硬链接转移：下载内容可自动链接至媒体库，便于整理和播放。
• 🎬 豆瓣想看同步：可绑定多个豆瓣账号，自动订阅“想看”影片。
• 🌱 新手友好：0门槛部署，适合NAS用户快速上。

🐳部署指南#

🎯 Docker Compose#

docker-compose.yml 文件

1
services:
2
  mediamaster:
3
    image: docker.1ms.run/smysong/mediamaster-v2:latest
4
    container_name: Mediamaster
5
    network_mode: host
6
    environment:
7
      - UID=1000
8
      - GID=1001
9
      - GIDLIST=1001修改
10
      - TZ=Asia/Shanghai
11
      - PORT=9009# 可选配置：自定义设置容器内应用端口，不提供则使用默认8888端口运行
12
    volumes:
13
      - /vol1/1000/Media:/Media#媒体库目录，可根据实际进行修改
14
      - /vol1/1000/Downloads:/Downloads#下载目录，可根据实际进行修改
15
      - ./mediamaster:/config#可根据实际进行修改
16
    restart:always
17

18
# transmission 不需要可删除。
19
transmission:
20
    image: docker.1ms.run/linuxserver/transmission:latest
21
    container_name: Transmission
22
    network_mode: host
23
    environment:
24
      - PUID=1000
25
      - PGID=1001
26
      - TZ=Asia/Shanghai
27
    volumes:
28
      - ./transmission:/config#可根据实际进行修改
29
      - /vol1/1000/Downloads:/downloads#可根据实际进行修改
30
    restart:always
31

32
# qbittorrent 不需要可删除
33
qbittorrent:
34
    image: docker.1ms.run/linuxserver/qbittorrent:latest
35
    container_name: Qbittorrent
36
    network_mode: host
37
    environment:
38
      - PUID=1000
39
      - PGID=1001
40
      - WEBUI_PORT=7008#可根据实际进行修改
41
      - TORRENTING_PORT=6881#可根据实际进行修改
42
      - TZ=Asia/Shanghai
43
    volumes:
44
      - ./qbittorrent:/config#可根据实际进行修改
45
      - /vol1/1000/Downloads:/downloads#可根据实际进行修改
46
    restart:always
47

48
# 迅雷 不需要可删除
49
xunlei:
50
    image: cnk3x/xunlei:latest
51
    privileged: true
52
    container_name: xunlei
53
    hostname: Fn_Nas
54
    network_mode: host
55
    volumes:
56
      - ./xunlei:/xunlei/data#可根据实际进行修改
57
      - /vol1/1000/Downloads:/xunlei/downloads#可根据实际进行修改
58
    restart: unless-stopped

展开收起

如果是 单独部署 或 包含下载器-Bridge模式部署，请参考快速部署[2]

1. 在飞牛主页面找到 Docker 打开后，切换菜单 Compose -> 新增项目

图片
2. 填写项目名称与路径，将 docker-compose.yml 内容粘贴到来源框

图片
3. 返回 Docker管理页面，在 容器菜单，就可以看到运行情况

图片

📖使用#

1. 使用浏览器访问 http://你的NAS地址:9009

图片

默认用户名：admin 默认密码：password
2. 首页

图片
3. 系统设置点击页面左侧系统设置，进行消息通知，媒体元数据等设置。

图片

图片

豆瓣订阅用户ID获取参考使用帮助[3]；TMDB API密钥默认内置了。如果自己有，尽量使用自己的密钥。

图片

迅雷下载需要进行配置，请参考迅雷下载功能如何使用？[4]

图片

私有（付费注册）站点配置说明：私有站点支持：高清剧集网[5]、高清影视之家[6]

图片

公开（免费注册）站点配置说明：公开站点支持：不太灵影视[7]、观影[8]、BT影视[9]

图片

站点索引开关和定时任务根据自己喜好进行设置。

图片

最后记得点击页面右上角保存配置 进行保存。
4. 热门推荐切换左侧的热门推荐，这里是 The Movie DataBase 里推荐的当前热门影视剧信息。

图片
5. 正在订阅管理正在订阅的电视剧/电影

图片
6. 资源搜索可以搜索并下载你追的电视剧/电影

图片

图片
7. 下载管理可以查看下载的电视剧/电影

图片

🎉 总结#

MediaMaster 基础功能已基本完善，在资源推荐、搜索、下载、刮削等方面表现不错。适合不熟PT、又懒得用TG找网盘资源的用户，真正实现一站式家庭影音体验。不过目前免费站点资源仍较匮乏，若后期支持自定义源，将更具扩展性与实用性。

引用链接#

[1] MediaMaster V2:https://github.com/smysong/mediamaster-v2 [2]快速部署:http://wiki.songmy.top:8080/web/#/686311457/102215684 [3]使用帮助:http://wiki.songmy.top:8080/web/#/686311457/102215711 [4]迅雷下载:http://wiki.songmy.top:8080/web/#/686311457/102215687 [5]高清剧集网:https://www.bthdtv.com/ [6]高清影视之家:https://www.hdbthd.com/ [7]不太灵影视:https://www.butailing.com/ [8]观影:https://www.gyg.si/ [9]BT影视:https://www.btbtl.com/

发现宝藏音乐播放器！MusicFree 让你告别广告和会员，想听什么听什么

2026-02-23T12:32:13.000Z

朋友们！我发现了一个超牛的音乐播放器！#

你们有没有过这样的经历？

打开音乐 app，满屏的广告，想听首歌还要开会员，不然只能试听 30 秒；想换个播放器，结果又要重新收藏歌单，麻烦得要命。

最近我发现了一个叫 MusicFree 的音乐播放器，简直是音乐爱好者的福音！今天必须强烈安利给你们！

什么是 MusicFree？#

MusicFree 是一个插件化、定制化、无广告的免费音乐播放器，有移动端和桌面端两个版本：

移动端：支持 Android 和 Harmony OS
桌面端：支持 Windows、macOS、Linux

为什么我这么喜欢 MusicFree？#

1️⃣ 完全免费，无广告#

最重要的是，MusicFree 完全免费，没有任何广告！不像某些音乐 app，打开就是广告，听两首歌又弹广告，烦都烦死了。

2️⃣ 插件化设计，想听什么听什么#

MusicFree 采用插件化设计，通过安装不同的插件，你可以收听来自不同平台的音乐，比如网易云、QQ音乐、酷狗等，再也不用为了听不同平台的歌而切换 app 了！

3️⃣ 定制化程度高#

MusicFree 支持自定义主题、背景，你可以根据自己的喜好打造属于自己的音乐播放器，超级个性化！

4️⃣ 多平台支持#

不管你是用手机还是电脑，都能使用 MusicFree，而且数据可以同步，超级方便！

5️⃣ 功能丰富#

MusicFree 支持搜索音乐、专辑、艺术家，播放音乐，查看专辑和艺术家详情，导入单曲和播放列表，获取歌词等功能，满足你对音乐播放器的所有需求。

我的使用体验#

前几天我下载了 MusicFree 桌面版，使用体验真的惊艳到我了：

界面简洁美观，没有乱七八糟的广告
通过插件，我可以搜索到各个平台的音乐，想听什么就听什么
支持自定义主题，我设置了一个我喜欢的深色主题，看起来超级舒服
歌词显示功能很贴心，还支持搜索歌词
播放列表管理也很方便，我可以轻松导入和管理我的歌单

如何开始使用？#

下载安装#

移动端：去 GitHub 搜索 “MusicFree”，下载对应版本安装
桌面端：去 GitHub 搜索 “MusicFreeDesktop”，下载对应系统的安装包安装

配置插件源#

使用 MusicFree 的关键是配置插件源，这样你才能获取到各种音乐平台的插件。

注意：不想找插件源的话，可以私信我发送【musicfree】获取哦！

配置步骤：

打开 MusicFree
进入设置页面
找到插件源设置
输入我私信给你的插件源 URL
点击确定，等待插件加载完成

开始使用#

配置好插件源后，你就可以：

搜索你喜欢的音乐
创建和管理播放列表
自定义播放器外观
享受无广告的音乐体验

适合谁用？#

音乐爱好者：不想被广告打扰，想听什么就听什么
学生党：预算有限，不想为音乐会员付费
上班族：通勤路上想听音乐，不想被广告打断
任何人：只要你喜欢听歌，想拥有一个干净、自由的音乐播放器

总结#

MusicFree 真的是一个宝藏音乐播放器，它插件化的设计让你可以收听来自不同平台的音乐，定制化的功能让你可以打造属于自己的播放器，最重要的是，它完全免费，没有广告！

如果你也受够了市面上那些充满广告和会员限制的音乐 app，一定要试试 MusicFree，相信你会和我一样爱上它！

如何获取插件源？#

想要使用 MusicFree 的全部功能，你需要配置插件源。插件源的 URL 我会私信发给关注我的微信公众号的朋友。

获取步骤：

关注我的微信公众号
发送 “MusicFree” 到公众号
我会私信给你插件源的 URL

项目地址#

移动端：https://github.com/maotoumao/MusicFree
桌面端：https://github.com/maotoumao/MusicFreeDesktop

互动时间#

你们平时用什么音乐播放器？有没有遇到和我一样的困扰？欢迎在评论区分享你的故事！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边喜欢听歌的朋友们～

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

需要简历不用愁！OpResume 免登录在线简历生成器，数据本地存储更安全

2026-02-23T12:32:13.000Z

朋友们！找工作、申请学校需要简历怎么办？#

最近有读者在后台问我：“小王，有没有好用的简历生成工具推荐？“，确实，简历是我们找工作、申请学校时必不可少的材料，一份好的简历能让你在众多竞争者中脱颖而出。

今天我要给大家推荐一个超好用的在线简历生成器——OpResume，它免登录、高颜值，而且数据仅存储在本地，不用担心隐私泄露的问题！

什么是 OpResume？#

OpResume 是一个免登录、高颜值的在线简历生成器，它的特点是数据仅本地存储，无泄漏风险，随时可以导出简历。

为什么推荐 OpResume？#

1️⃣ 免登录，即用即走#

OpResume 不需要注册登录，打开网页就能使用，非常方便。你不需要填写任何个人信息，也不用担心账号安全问题。

2️⃣ 数据本地存储，隐私安全#

所有数据都存储在你的浏览器本地，不会上传到任何服务器，完全不用担心个人信息泄露的风险。

3️⃣ 高颜值模板#

OpResume 提供了多种高颜值的简历模板，你可以根据自己的需求选择适合的模板，让你的简历看起来更加专业、美观。

4️⃣ 操作简单，上手快#

OpResume 的界面简洁直观，操作非常简单，即使是第一次使用，也能很快上手。

5️⃣ 随时导出，格式多样#

你可以随时导出简历，支持多种格式，方便你在不同场合使用。

如何使用 OpResume？#

步骤1：访问在线地址#

打开浏览器，访问 OpResume 的在线地址：https://opresume.pages.dev/

步骤2：选择模板#

在首页选择一个你喜欢的简历模板。

步骤3：填写信息#

根据模板的提示，填写你的个人信息、教育背景、工作经历、项目经验等内容。

步骤4：预览简历#

填写完成后，你可以实时预览简历的效果，根据需要进行调整。

步骤5：导出简历#

满意后，点击导出按钮，选择你需要的格式，下载简历。

我的使用体验#

前几天我试用了 OpResume，体验真的非常好：

免登录：打开网页就能使用，不用填写任何个人信息
界面美观：模板设计非常现代，看起来很专业
操作简单：填写信息的过程非常流畅，没有复杂的操作
实时预览：可以实时看到简历的效果，方便调整
导出方便：支持多种格式导出，满足不同需求

最重要的是，所有数据都存储在本地，不用担心隐私泄露的问题，这一点真的很贴心！

适合谁用？#

求职者：需要制作简历找工作
学生：申请学校、实习需要简历
职场人士：更新简历，寻求更好的职业机会
任何人：需要制作专业简历的人

项目地址#

如果你对 OpResume 感兴趣，可以访问它的 GitHub 仓库：https://github.com/oopooa/opresume

在线地址#

你可以直接访问 OpResume 的在线地址开始使用：https://opresume.pages.dev/

互动时间#

你们平时是如何制作简历的？使用 OpResume 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

挖到宝了！这款免费影视神器，聚合全网资源还能多端同步，错过亏大了！

2026-02-23T12:32:13.000Z

你是不是也遇到过这些问题？想看的剧分散在 N 个平台，充值会员看到手软；换个设备追剧，进度总是要重新找；网页端广告弹窗比剧情还精彩…

今天给大家安利一款开源宝藏工具 ——MoonTV，一个能把这些烦恼一次性解决的影视聚合播放器。亲测好用到飞起，必须分享给你们！

image-20250726090117801

✨ 它到底有多能打？#

作为一款基于 Next.js 构建的跨平台工具，MoonTV 的功能简直是为追剧党量身定做：

✅ 全网资源一键搜：内置数十个免费影视站点，不用再逐个平台切换，一次搜索就能 get 所有结果

✅ 追剧进度不丢失：不管在手机、电脑还是平板上看，收藏和播放记录自动同步，再也不用记住看到第几集

✅ 无广告纯净体验：实验性的智能去广告功能，自动跳过视频切片广告，追剧更沉浸

✅ 能装到桌面 / 手机：支持 PWA 安装，像原生 App 一样使用，离线也能缓存内容

✅ 完全免费开源：代码透明可查，没有隐藏收费，还能自己部署到服务器

image-20250726094152924

🚀 小白也能轻松上手#

最让人惊喜的是，它的部署门槛低到离谱，几种方式任你选：

👉 Docker 部署（懒人首选）

这种方式操作简单，30 秒就能搞定部署，适合对技术不太熟悉的小白。

首先确保你的电脑或服务器已经安装了 Docker，如果没有，可以去 Docker 官网下载并安装对应版本的 Docker Desktop。
打开终端或命令提示符，输入以下命令：docker run -d -p 3000<3000> —name moontv senshinya/moontv
等待命令执行完成，然后在浏览器中输入http://localhost<3000>，就可以访问 MoonTV 了。

👉 部署到 Vercel（免费方案）

Vercel 提供了免费的部署服务，适合不想自己搭建服务器的用户。

首先你需要有一个 GitHub 账号，并且将 MoonTV 仓库 Fork 到自己的账号下。
访问 Vercel 官网，使用 GitHub 账号登录。
在 Vercel dashboard 中，点击 “New Project”，然后选择你 Fork 的 MoonTV 仓库。
点击 “Deploy” 按钮，Vercel 会自动进行部署，等待部署完成后，会生成一个访问链接，通过该链接即可访问你的 MoonTV。

👉 部署到 Cloudflare（免费方案）

Cloudflare 的 Pages 服务也是免费的，部署步骤如下。

同样需要先将 MoonTV 仓库 Fork 到自己的 GitHub 账号。
登录 Cloudflare 账号，进入 Pages 服务页面。
点击 “Create a project”，选择 “Connect to Git”，然后选择你 Fork 的 MoonTV 仓库。
在配置页面，框架预设选择 “Next.js”，然后点击 “Deploy site”。
等待部署完成，Cloudflare 会生成一个访问域名，通过该域名就能使用 MoonTV 了。

部署后还能自定义站点名称、公告，甚至添加自己常用的资源站，完全按你的喜好来定制。而且搭配 Redis 还能实现多设备同步，支持多账户管理，家庭共用也方便。

部署后还能自定义站点名称、公告，甚至添加自己常用的资源站，完全按你的喜好来定制。

🛡️ 安全提示要记牢#

虽然好用，但也要提醒大家：

部署时一定要设置密码，避免被陌生人滥用
仅供个人学习使用，不要公开分享你的站点
遵守当地法律法规，合理使用网络资源

🌟 最后说两句#

现在市面上的影视工具要么广告泛滥，要么收费高昂，MoonTV 这种开源免费还好用的实属难得。

如果你也是个追剧爱好者，或者想搭一个私人影视库，这个项目绝对值得试试。项目地址我放下面了，记得给开发者点个星哦～

👉 MoonTV 项目地址

（注：请支持正版影视内容，合理使用工具，遵守相关规定）

开源 LibreTV：一款开源免费的在线视频搜索神器，一键部署私人观影平台

2026-02-23T12:32:13.000Z

最近发现了一个超赞的开源项目——LibreTV，这是一款轻量级、免费的在线视频搜索与观看平台。无需注册登录，打开就能用，还支持多设备访问。今天就来给大家详细介绍下这个项目，以及如何快速部署属于自己的私人观影实例。

🌟 LibreTV 是什么？#

LibreTV 是一个基于 Web 技术的视频搜索与播放平台，它聚合了多个视频源，让你能轻松找到想看的内容。项目基于 bestK/tv 重构增强，保留了核心功能并优化了用户体验。

最吸引人的是，它完全开源免费，没有广告干扰，还支持自行部署，打造专属的无广告观影环境。

点击查看项目截图

🚀 技术栈解析#

作为技术爱好者，不得不提一下它的技术栈：

前端：HTML5 + CSS3 + JavaScript (ES6+)、Tailwind CSS
视频播放：HLS.js 处理流媒体、DPlayer 作为播放器核心
后端：支持 Cloudflare/Vercel/Netlify 等 Serverless 环境
存储：使用 localStorage 保存播放记录

这种技术组合让它既能保证良好的用户体验，又能灵活部署在各种平台上。

🔧 多种部署方式任选#

LibreTV 支持多种部署方式，无论你是技术小白还是资深开发者，都能找到适合自己的方案。

1. 一键部署（推荐新手）#

几个主流平台都支持一键部署，点击按钮即可：

2. Docker 部署（推荐有服务器用户）#

如果你有自己的服务器，Docker 部署是个好选择：

Terminal window

1
docker run -d \
2
  --name libretv \
3
  --restart unless-stopped \
4
  -p 8899:8080 \
5
  -e PASSWORD=你的密码 \
6
  -e ADMINPASSWORD=管理员密码 \
7
  bestzwei/libretv:latest

启动后访问 http://服务器IP:8899 即可。

或者使用 Docker Compose：

1
services:
2
  libretv:
3
    image: bestzwei/libretv:latest
4
    container_name: libretv
5
    ports:
6
      - "8899:8080"
7
    environment:
8
      - PASSWORD=你的密码
9
      - ADMINPASSWORD=管理员密码
10
    restart: unless-stopped

启动命令：docker compose up -d

3. 本地开发环境（适合开发者）#

如果你想研究源码或参与开发，可以搭建本地环境：

Terminal window

1
# 克隆仓库
2
git clone https://github.com/LibreSpark/LibreTV.git
3
cd LibreTV
4

5
# 安装依赖
6
npm install
7

8
# 配置环境变量（可选）
9
cp .env.example .env
10

11
# 启动开发服务器
12
npm run dev

访问 http://localhost:8080 即可使用。

🔒 安全设置建议#

为了避免不必要的麻烦，强烈建议进行以下安全设置：

设置密码保护：在部署时添加 PASSWORD 环境变量，设置访问密码
限制访问范围：尽量只在个人或小范围使用，不要公开分享
遵守法律法规：确保你的使用行为符合当地法律要求

各平台设置环境变量的位置：

Cloudflare Pages：项目设置 > 环境变量
Vercel：项目 Settings > Environment Variables
Netlify：项目 Site settings > Build & deploy > Environment

🎁 为什么选择 LibreTV？#

开源免费：完全开源，无任何隐藏收费
无需注册：打开就能用，保护隐私
多源聚合：聚合多个视频源，内容更丰富
轻量高效：界面简洁，加载快速
自定义强：支持自行部署和个性化配置

📝 最后声明#

LibreTV 仅作为视频搜索工具，不存储、上传或分发任何视频内容。所有视频均来自第三方 API 接口提供的搜索结果。使用时请遵守当地法律法规，支持正版内容。

如果你觉得这个项目不错，不妨去 GitHub 给个 Star 支持一下：https://github.com/LibreSpark/LibreTV

希望这篇介绍对你有帮助，祝大家观影愉快！

搜集安卓端、TV 端、苹果端、Windows 端、Mac 端各种版本的影视盒子下载地址

2026-02-23T12:32:13.000Z

1. 安卓端（含手机、平板）#

软件专区	版本类型	下载链接
影视仓空壳专区	安卓端	https://streamshare.wireway.ch/download/dhpo6wqq
OK 影视空壳专区 okjack	安卓端 - v7a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/okjack/apk/release/mobile-armeabi_v7a.apk
OK 影视空壳专区 okjack	安卓端 - v8a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/okjack/apk/release/mobile-arm64_v8a.apk
OK 影视空壳专区 Fongmi	安卓端 - v7a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/fongmi/apk/release/mobile-armeabi_v7a.apk
OK 影视空壳专区 Fongmi	安卓端 - v8a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/fongmi/apk/release/mobile-arm64_v8a.apk
OK 影视 PRO 空壳专区	安卓端	https://streamshare.wireway.ch/download/c4l80qsz
UZ 影视空壳专区	安卓端	https://streamshare.wireway.ch/download/1iewmue8
蛋播星球专区 (内置源)	安卓端	https://streamshare.wireway.ch/download/kyvbchy8
ClashMeta 专区	安卓端 v7a	https://gh-proxy.com/https://github.com/MetaCubeX/ClashMetaForAndroid/releases/download/v2.11.15/cmfa-2.11.15-meta-armeabi-v7a-release.apk
ClashMeta 专区	安卓端 v8a	https://gh-proxy.com/https://github.com/MetaCubeX/ClashMetaForAndroid/releases/download/v2.11.15/cmfa-2.11.15-meta-arm64-v8a-release.apk
ClashMi 专区	安卓端	https://dot.clashmi.app/client.html?tag=android-stable
Karing 专区	安卓端	https://dot.karing.app/client.html?tag=android-stable

2. TV 端（含电视、电视盒子）#

软件专区	版本类型	下载链接
影视仓空壳专区	TV 端	https://streamshare.wireway.ch/download/sbv5fvw4
OK 影视空壳专区 okjack	TV 端 - v7a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/okjack/apk/release/leanback-armeabi_v7a.apk
OK 影视空壳专区 okjack	TV 端 - v8a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/okjack/apk/release/leanback-arm64_v8a.apk
OK 影视空壳专区 okjack	海信专用	https://gh-proxy.com/https://github.com/FongMi/Release/blob/okjack/apk/release/ 海信专版.apk
OK 影视空壳专区 okjack	X5 离线	https://gh-proxy.com/https://github.com/FongMi/Release/blob/okjack/apk/release/ 电视版 - X5 离线.apk
OK 影视空壳专区 Fongmi	TV 端 - v7a	https://gh-proxy.com/https://github.com/FongMi/Release/blob/fongmi/apk/release/leanback-armeabi_v7a.apk
OK 影视空壳专区 Fongmi	TV 端 - v8a	https://gh-proxy.com/github.com/FongMi/Release/blob/fongmi/apk/release/leanback-arm64_v8a.apk
OK 影视 PRO 空壳专区	TV 端	https://streamshare.wireway.ch/download/ru3relsn
酷 9 原版空壳专区	TV 端	https://streamshare.wireway.ch/download/ybyzclnf
酷 9 原版空壳专区	TV 端 lite	https://streamshare.wireway.ch/download/olty7z6s
酷 9 魔改空壳专区	半透明版 / 布局版等	（注：均适配 TV，以具体链接为准，示例：半透明版）
DIYP 影音空壳专区	TV 经典版	https://streamshare.wireway.ch/download/g6xmkr37
DIYP 影音空壳专区	TV 最终版	https://streamshare.wireway.ch/download/13lz0t0w
派大星空壳专区	TV 端 1.0.5	https://streamshare.wireway.ch/download/8vr0a8lo
派大星空壳专区	TV 端 1.0.6	https://streamshare.wireway.ch/download/to3j9w01
UZ 影视空壳专区	电视端	https://streamshare.wireway.ch/download/y5af8psn
ClashMeta 专区	电视端	https://gh-proxy.com/https://github.com/MetaCubeX/ClashMetaForAndroid/releases/download/v2.11.15/cmfa-2.11.15-meta-universal-release.apk
ClashMi 专区	电视端	https://dot.clashmi.app/client.html?tag=android-armv7a-stable
Karing 专区	电视端	https://dot.karing.app/client.html?tag=android-armv7a-stable

3. 苹果端（含 iPhone、iPad）#

软件专区	版本类型	下载链接
UZ 影视空壳专区	苹果端	https://streamshare.wireway.ch/download/zg9z7hq9
蛋播星球专区 (内置源)	苹果端	https://testflight.apple.com/join/U1uy34cq
自娱播放器空壳专区	苹果专属	https://apps.apple.com/cn/app/%E8%87%AA%E5%A8%B1%E6%92%AD%E6%94%BE%E5%99%A8/id6747301490
魔力云播空壳专区	苹果专属	https://testflight.apple.com/join/ywzcMKS3
MiraPlay 空壳专区	苹果专属	https://testflight.apple.com/join/4N2pkqa3
ClashMi 专区	苹果端	https://testflight.apple.com/join/bjHXktB3
Karing 专区	苹果端	https://testflight.apple.com/join/RLU59OsJ

4. Windows 端（含 PC、笔记本）#

软件专区	版本类型	下载链接
OK 影视 PRO 空壳专区	模拟器专版	https://streamshare.wireway.ch/download/xrg9wxlh
UZ 影视空壳专区	Win 端	https://streamshare.wireway.ch/download/x5xa2cvl
蛋播星球专区 (内置源)	Win 端	https://streamshare.wireway.ch/download/4016c1lw
ClashMi 专区	Win 端	https://dot.clashmi.app/client.html?tag=windows-installer-stable
Karing 专区	Win 端	https://dot.karing.app/client.html?tag=windows-installer-stable
Mihomo-party 专区	Win10/11-32 位	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-windows-1.7.7-ia32-setup.exe
Mihomo-party 专区	Win10/11-64 位	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-windows-1.7.7-x64-setup.exe
Mihomo-party 专区	Win7/8-32 位	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-win7-1.7.7-ia32-setup.exe
Mihomo-party 专区	Win7/8-64 位	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-win7-1.7.7-x64-setup.exe

5. Mac 端（含 Intel、Apple Silicon 芯片）#

软件专区	版本类型	下载链接
UZ 影视空壳专区	Mac 端	https://streamshare.wireway.ch/download/5upxguqe
蛋播星球专区 (内置源)	Mac-M 芯片	https://streamshare.wireway.ch/download/4s93ir77
ClashMi 专区	Mac 端	https://dot.clashmi.app/client.html?tag=macos-beta
Mihomo-party 专区	Mac-lntel-11+	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-macos-1.7.7-x64.pkg
Mihomo-party 专区	Mac-AppleSilicon-11+	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-macos-1.7.7-arm64.pkg
Mihomo-party 专区	Mac-lntel-10.15+	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-catalina-1.7.7-x64.pkg
Mihomo-party 专区	Mac-AppleSilicon-10.15+	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-catalina-1.7.7-arm64.pkg

6. 其他设备（Linux、鸿蒙、X86 专用）#

设备类型	软件专区	版本类型	下载链接
Linux	Mihomo-party 专区	Linux-DEB-64 位	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-linux-1.7.7-amd64.deb
Linux	Mihomo-party 专区	Linux-ARM64	https://gh-proxy.com/https://github.com/mihomo-party-org/mihomo-party/releases/download/v1.7.7/mihomo-party-linux-1.7.7-arm64.deb
鸿蒙	Karing 专区	鸿蒙端	https://gh-proxy.com/https://github.com/KaringX/karing/releases/download/v1.0.23-275/karing_1.0.23.275_android_arm64.apk
X86 专用	UZ 影视空壳专区	X86 专用	https://streamshare.wireway.ch/download/rle4gdl8
X86 专用	ClashMeta 专区	X86	https://gh-proxy.com/https://github.com/MetaCubeX/ClashMetaForAndroid/releases/download/v2.11.15/cmfa-2.11.15-meta-x86-release.apk

iOS用户福音！Cymusic 音乐播放器使用教程，一步到位让你免费听遍全网音乐

2026-02-23T12:32:13.000Z

回应读者：iOS 移动端音乐播放器安排上了！#

前几天有读者在后台问小王：“有没有推荐的 iOS 移动端音乐播放器呀？“，小王一直在找合适的推荐，终于找到了一个超棒的 iOS 音乐播放器——Cymusic！

今天小王就给大家带来一份详细的 Cymusic 使用教程，一步到位让你免费听遍全网音乐！

什么是 Cymusic？#

Cymusic 是一款专为 iOS 设备打造的音乐播放器，它支持多音乐源、歌曲搜索、歌单导入等功能，让你在 iOS 设备上也能免费听遍全网音乐！

准备工作#

在开始使用 Cymusic 之前，你需要准备以下东西：

一台 iOS 设备（iPhone 或 iPad）
稳定的网络连接
Cymusic 应用（下载地址私信小王获取）
音源文件（同样私信小王获取）

安装 Cymusic#

方法一：使用巨魔安装（推荐）#

首先在你的 iOS 设备上安装巨魔（TrollStore）
打开巨魔，点击”+“按钮
选择从小王这里获取的 Cymusic IPA 文件
等待安装完成

方法二：使用证书自签安装#

在电脑上下载 Cydia Impactor 或其他自签工具
将 iOS 设备连接到电脑
打开自签工具，选择 Cymusic IPA 文件
输入你的 Apple ID 和密码
等待安装完成

导入音源#

安装完成后，你需要导入音源文件才能使用 Cymusic：

首先将从小王这里获取的音源文件下载到你的 iOS 设备中
打开 Cymusic 应用
点击右上角的三条杠图标
选择”导入音源”
选择你下载的音源文件
等待导入完成

使用教程#

搜索歌曲#

打开 Cymusic 应用
在搜索栏中输入你想要搜索的歌曲名称或歌手名称
点击搜索按钮
从搜索结果中选择你想要的歌曲
点击播放按钮开始播放

导入歌单#

打开 Cymusic 应用
点击右上角的三条杠图标
选择”导入歌单”
在输入栏中粘贴歌单链接
点击”导入”按钮
等待导入完成

调整设置#

打开 Cymusic 应用
点击右上角的三条杠图标
选择”设置”
在这里你可以调整播放设置、下载设置等

功能特点#

Cymusic 具有以下功能特点：

多音乐源：支持多个音乐平台的音源
歌曲搜索：可以搜索歌曲和歌手
歌单导入：支持导入外部歌单
歌曲下载：可以下载歌曲到本地
界面美观：简洁美观的用户界面
免费使用：完全免费，无广告

项目地址#

如果你对 Cymusic 感兴趣，可以访问它的 GitHub 仓库：https://github.com/gyc-12/Cymusic

如何获取下载地址？#

想要获取 Cymusic 的下载地址和音源文件，请按照以下步骤操作：

关注小王的微信公众号
发送 “Cymusic” 到公众号
小王会私信给你下载地址和音源文件

互动时间#

你们平时在 iOS 设备上用什么音乐播放器？使用 Cymusic 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，小王会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

【工具】三步实现【DeepSeek】本地部署,构建自己的AI智能体

2026-01-23T12:32:13.000Z

前言#

近年来，国产大模型DeepSeek备受关注，但随着用户访问量激增，频繁出现响应缓慢甚至系统宕机的现象，给使用者带来了一些不便。幸运的是，DeepSeek作为开源模型，允许开发者通过本地部署来解决这一问题。将模型部署到本地后，用户无需依赖网络即可随时进行推理操作，不仅提升了使用体验，还大幅降低了对外部服务的依赖。

image-20250218143823515

安装 Ollama#

要在本地运行 DeepSeek，我们需要使用 Ollama——一个开源的本地大模型运行工具

首先，访问 Ollama官网下载该工具。官网提供了针对不同操作系统的安装包，用户只需选择适合自己电脑的版本即可。在本例中，我们选择下载适用于 Windows 操作系统的版本。

*** 注意：官网的下载地址为github网站的地址，因为一些原因，部分地区无法访问，大家可以使用Watt Toolkit 进行网络加速，或者使用好心人部署的文件加速网站进行下载 **

image-20250218144607214

Ollama 安装包下载后双击install，安装速度还是比较快的**（注：直接安装到C盘,无法更改位置，下载的模型也在C盘）**

安装完成 Ollama 后，打开电脑的 CMD（命令提示符）。只需在电脑下方的搜索框中输入“cmd”并按回车，即可打开命令提示符窗口。输入**【ollama help】**，出现下图，则代表已经安装成功了

image-20250218144838005

下载部署 Deepseek 模型#

解决GitHub访问慢的神器！fetch-github-hosts 让你秒开GitHub，再也不用等加载了

2026-01-23T12:32:13.000Z

朋友们！GitHub访问慢的问题终于有解决方案了！#

前阵子我给大家分享了很多优秀的 GitHub 开源项目，比如 MusicFree、COCO 音乐下载站、Melody Hub、Cymusic 等，这些都是非常棒的工具。但是，有读者在后台反映，GitHub 在国内访问速度太慢了，有时候甚至根本打不开，导致无法下载这些优秀的开源项目。

今天我要给大家介绍一个专门解决 GitHub 访问问题的神器——fetch-github-hosts，它能帮你快速访问 GitHub，再也不用忍受缓慢的加载速度了！

什么是 fetch-github-hosts？#

fetch-github-hosts 是一个用于同步 GitHub hosts 的工具，主要为解决研究及学习人员访问 GitHub 过慢或其他问题而提供。它通过部署服务器来获取 github.com 的 hosts，而不是通过第三方 IP 地址接口来进行获取，更加稳定可靠。

为什么需要 fetch-github-hosts？#

如果你经常访问 GitHub，你可能会遇到以下问题：

访问 GitHub 速度缓慢，页面加载需要很久
有时候甚至无法打开 GitHub 网站
克隆或下载 GitHub 项目速度很慢
无法正常登录 GitHub 账号

这些问题都是由于 GitHub 在国内的访问限制导致的。fetch-github-hosts 通过更新 hosts 文件，让你的电脑直接访问 GitHub 的服务器，从而绕过这些限制，提高访问速度。

功能特点#

fetch-github-hosts 具有以下功能特点：

多平台支持：支持 Windows、macOS、Linux 等多种操作系统
多种界面：支持图形化界面和命令行界面
内置两种模式：客户端模式和服务端模式
自动更新：可以设置自动更新 hosts 文件
简单易用：操作简单，即使是技术小白也能轻松使用

如何使用 fetch-github-hosts？#

Windows 系统#

方法一：使用图形化界面#

下载并安装 fetch-github-hosts（访问不了github的可以私信我获取）
以管理员身份运行应用程序
点击”更新 hosts”按钮
等待更新完成（会显示更新成功的提示）
刷新浏览器，重新访问 GitHub

方法二：使用命令行#

下载并解压 fetch-github-hosts（访问不了github的可以私信我获取）
以管理员身份打开命令提示符
进入解压目录，例如：cd D:\fetch-github-hosts
启动客户端

Terminal window

1
# Windows
2
fetch-github-hosts.exe -m client
3
# 自定义获取间隔（10分钟）
4
sudo ./fetch-github-hosts -m client -i 10
5
# 自定义获取链接
6
sudo ./fetch-github-hosts -m client -u http://127.0.0.1:9898/hosts.json

启动服务端

Terminal window

1
# Windows
2
fetch-github-hosts.exe -m server
3

4
# 自定义端口
5
./fetch-github-hosts -m server -p 6666
6

7
# 自定义 HTML 模板文件
8
./fetch-github-hosts -m server -t /path/to/template.html

刷新 DNS 缓存

Terminal window

1
# Windows
2
ipconfig /flushdns

等待更新完成（会显示更新成功的提示）
刷新浏览器，重新访问 GitHub

macOS 系统#

使用命令行界面#

下载并解压 fetch-github-hosts（访问不了github的可以私信我获取）
以管理员身份打开命令提示符
进入解压目录，例如：cd D:\fetch-github-hosts
启动客户端

Terminal window

1
# Linux/macOS
2
sudo ./fetch-github-hosts -m client
3
# 自定义获取间隔（10分钟）
4
sudo ./fetch-github-hosts -m client -i 10
5
# 自定义获取链接
6
sudo ./fetch-github-hosts -m client -u http://127.0.0.1:9898/hosts.json

启动服务端

Terminal window

1
# Linux/macOS
2
# Linux/macOS
3
./fetch-github-hosts -m server
4

5
# 自定义端口
6
./fetch-github-hosts -m server -p 6666
7

8
# 自定义 HTML 模板文件
9
./fetch-github-hosts -m server -t /path/to/template.html

刷新 DNS 缓存

Terminal window

1
# macOS
2
sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder

等待更新完成（会显示更新成功的提示）
刷新浏览器，重新访问 GitHub

注意事项#

首次使用时，可能需要关闭防火墙或安全软件，以免阻止修改 hosts 文件
如果更新后仍然访问速度较慢，可以尝试重启浏览器或电脑
建议定期更新 hosts 文件，因为 GitHub 的 IP 地址可能会变化
如果遇到问题，可以尝试以管理员/root 权限运行程序

我的使用体验#

前几天我使用了 fetch-github-hosts，效果真的非常明显：

之前访问 GitHub 首页需要 10 多秒，现在只需要 1-2 秒
克隆 GitHub 项目的速度从之前的几 KB/s 提升到了几 MB/s
再也没有遇到无法打开 GitHub 的情况

现在我可以轻松访问之前分享的那些优秀开源项目，下载速度也快了很多！

适合谁用？#

开发者：需要经常访问 GitHub 查看代码、克隆项目
学生：需要在 GitHub 上学习开源项目
技术爱好者：喜欢探索各种开源工具
任何人：需要访问 GitHub 的人

项目地址#

如果你对 fetch-github-hosts 感兴趣，可以访问它的 GitHub 仓库：https://github.com/Licoy/fetch-github-hosts

互动时间#

你们平时访问 GitHub 时遇到过什么问题？使用 fetch-github-hosts 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

发现宝藏音乐软件！LX Music 让你告别多 app 切换，一个软件听遍所有平台

2026-01-23T12:32:13.000Z

朋友们！我发现了一个超好用的音乐软件！#

最近我被音乐软件搞烦了——想听周杰伦的歌要开某易云，想听林俊杰的歌要开某 Q 音乐，想听一些冷门歌曲又要换别的 app，手机里装了五六个音乐软件，占空间不说，切换来切换去真的麻烦死了！

直到我发现了这款LX Music（洛雪音乐），简直打开了新世界的大门！今天必须给你们安利一波！

什么是 LX Music？#

简单来说，LX Music 是一个免费的音乐播放器，最牛的地方是它能同时搜索多个音乐平台的歌曲，不用再切换 app 就能听到所有平台的音乐！而且电脑和手机都能用，超方便～

为什么我推荐 LX Music？#

1️⃣ 一个软件听遍所有平台#

以前我为了听歌，手机里装了某易云、某 Q 音乐、某酷音乐…现在好了，有了 LX Music，我只需要打开一个 app，就能搜索到各个平台的歌曲，再也不用来回切换了！

2️⃣ 完全免费，无广告#

最重要的是，这个软件完全免费，没有任何广告！不像某些音乐软件，听两首歌就弹广告，烦都烦死了。

3️⃣ 电脑手机都能用#

它有桌面版和移动版，不管你是用电脑还是手机，都能无缝切换，而且还支持同步歌单，在电脑上创建的歌单，打开手机 app 就能继续听，超方便！

4️⃣ 操作简单，小白友好#

虽然官方说“不以新手友好为目标”，但我用下来觉得操作其实挺简单的，就是普通音乐播放器的界面，上手很快。

5️⃣ 支持下载歌曲#

遇到喜欢的歌曲，还能直接下载到本地，没网的时候也能听，太贴心了！

怎么使用 LX Music？#

下载安装#

电脑版：去 GitHub 搜索“lx-music-desktop”，找到 Releases 页面下载对应系统的安装包，安装就行
手机版：搜索“lx-music-mobile”，下载 APK 文件安装到手机

首次使用小技巧#

打开软件后，先在设置里调整一下自己喜欢的界面风格
直接在搜索框里输入歌曲名，就能看到来自不同平台的结果
点击歌曲就能播放，还能添加到歌单
如果想同步歌单，可以在设置里配置同步服务

我用 LX Music 的真实体验#

自从用了 LX Music，我的手机桌面清爽了很多，再也没有一堆音乐 app 了。早上通勤的时候，我会打开手机版听喜欢的歌；晚上回家用电脑工作时，打开桌面版继续听，歌单都是同步的，超级方便！

前几天我想找一首比较冷门的日文歌，在其他平台都搜不到，结果在 LX Music 里一下就找到了，真的惊喜！

适合谁用？#

音乐爱好者：不想装多个音乐 app，想一站式听歌的朋友
学生党：预算有限，不想为音乐会员付费的同学
上班族：通勤路上想听音乐，不想切换 app 的打工人
任何人：只要你喜欢听歌，想更方便地享受音乐，都可以试试！

注意事项#

软件是开源的，完全免费，大家可以放心使用
记得支持正版音乐，尊重版权哦
下载的歌曲建议在 24 小时内删除，避免侵权

总结#

LX Music 真的是我最近发现的宝藏软件，解决了我听歌的大麻烦。如果你也像我一样，被多个音乐 app 搞得头疼，一定要试试它！

不用花一分钱，就能享受一站式的音乐体验，何乐而不为呢？

下载地址#

电脑版：https://github.com/lyswhut/lx-music-desktop
手机版：https://github.com/lyswhut/lx-music-mobile

互动时间#

你们平时用什么音乐软件？有没有遇到和我一样的困扰？欢迎在评论区分享你的音乐故事！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边喜欢听歌的朋友们～

如果下载失败或打开时空白的没有音源，可以私信小王，发送『音乐』，给你提供安装包和音源文件。

推荐阅读：

（注：文章部分信息来源于项目官方文档）

发现免费在线PS替代品！Photopea让你不用安装软件也能专业修图

2026-01-23T12:32:13.000Z

朋友们！我发现了一个超厉害的在线图片编辑工具！#

最近我想修几张照片，但是电脑里没有装 Photoshop，下载安装又麻烦，而且正版还挺贵的。就在我纠结的时候，朋友给我推荐了一个在线图片编辑器——Photopea，简直是救星！今天必须分享给你们！

什么是 Photopea？#

简单来说，Photopea 是一个完全免费的在线图片编辑器，它的功能和界面都和 Photoshop 非常相似，但是不需要下载安装，直接在浏览器里打开就能用，而且完全免费！

为什么我推荐 Photopea？#

1️⃣ 完全免费，无需安装#

最重要的是，Photopea 完全免费，不用花一分钱就能使用专业的图片编辑功能。而且不需要下载安装任何软件，打开浏览器访问 https://www.photopea.com/ 就能开始编辑图片，超级方便！

2️⃣ 功能强大，堪比 PS#

虽然是在线工具，但 Photopea 的功能一点也不逊色于 Photoshop：

基础编辑：裁剪、调整大小、旋转、翻转等
高级功能：图层、蒙版、混合模式、滤镜等
颜色调整：亮度、对比度、色阶、曲线、色彩平衡等
工具齐全：选择工具、画笔工具、文本工具、形状工具等

3️⃣ 支持多种文件格式#

Photopea 支持打开和编辑多种文件格式，包括：

PSD：完全支持 Photoshop 的 PSD 格式，能打开和保存
常见图片格式：PNG、JPG、GIF、BMP、WEBP、SVG 等
专业格式：PDF、AI、AVIF、DDS、HEIC、TIFF、EPS 等
RAW 格式：支持 DNG、CR2、CR3、NEF、ARW 等相机 RAW 文件

4️⃣ RAW 文件支持#

如果你是摄影爱好者，Photopea 还支持直接打开和编辑相机 RAW 文件，调整曝光、色彩平衡、对比度、高光和阴影等参数，就像专业的 RAW 编辑器一样！

5️⃣ 界面友好，上手简单#

Photopea 的界面和 Photoshop 非常相似，如果你用过 PS，几乎可以无缝切换。即使你是第一次使用，界面也很直观，容易上手。

我用 Photopea 的真实体验#

前几天我用 Photopea 修了一组旅行照片，体验真的很棒：

打开网站，直接拖拽照片进去就能开始编辑
用裁剪工具调整构图，用曲线工具调整曝光
添加文字、滤镜，调整色彩平衡
最后保存为 JPG 格式，效果和用 PS 修的差不多

整个过程流畅，没有卡顿，而且完全免费，太香了！

适合谁用？#

学生党：预算有限，不想花钱买 PS，又需要做图的同学
职场人士：偶尔需要修图，不想安装大型软件的打工人
摄影爱好者：需要简单编辑照片，调整 RAW 文件的朋友
设计新手：想学习图片编辑，又不想投入太多成本的初学者
任何人：只要你需要编辑图片，又不想麻烦安装软件，都可以试试！

如何使用 Photopea？#

使用 Photopea 非常简单：

打开浏览器，访问 https://www.photopea.com/
点击”打开”按钮上传图片，或者直接拖拽图片到页面
使用左侧工具栏的各种工具进行编辑
编辑完成后，点击”文件”→“导出为”，选择格式保存

Docker 部署教程#

如果你想在自己的服务器或 NAS 上部署 Photopea，方便随时随地使用，还可以通过 Docker 来部署。以下是详细步骤：

1️⃣ 准备工作#

首先，确保你的设备上已经安装了 Docker。如果还没有安装，可以参考 Docker 官方文档进行安装。

2️⃣ 拉取并运行 Photopea 容器#

打开终端或命令行工具，执行以下命令：

1
services:
2
 photopea:
3
  image: ramuses/photopea:latest
4
  container_name: photopea
5
  ports:
6
   - 8887:8887
7
  restart: unless-stopped

3️⃣ 访问 Photopea#

部署完成后，打开浏览器，访问 http://你的服务器IP:8887 即可使用本地部署的 Photopea。

4️⃣ 注意事项#

如果你修改了端口映射，记得使用你设置的端口访问
确保你的服务器防火墙允许该端口的访问
本地部署的 Photopea 功能与在线版本相同，但数据存储在本地，更加安全

总结#

Photopea 真的是一个宝藏在线图片编辑器，完全免费，功能强大，无需安装，支持多种文件格式，甚至能处理 RAW 文件。无论是直接使用在线版本，还是通过 Docker 部署到本地，都能为你提供专业级的图片编辑体验。

如果你需要编辑图片，又不想安装大型软件，或者预算有限，Photopea 绝对是你的不二选择！

不用花一分钱，就能享受到专业级的图片编辑体验，何乐而不为呢？

访问地址#

在线版本：https://www.photopea.com/
本地部署：http://你的服务器IP:8887（Docker 部署后）

互动时间#

你们平时用什么工具编辑图片？有没有遇到过需要修图但没有软件的情况？欢迎在评论区分享你的经历！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边需要修图的朋友们～

推荐阅读：

（注：文章部分信息来源于 Photopea 官网）

Project N.O.M.A.D.：离线生存电脑，知识永不离线

2025-12-23T12:32:13.000Z

嗨，户外爱好者和生存主义者们！#

想象一下，当你远离城市，深入荒野，或者遇到网络中断的紧急情况时，如何获取关键信息和工具？今天要给你们介绍一个超级酷的项目——Project N.O.M.A.D.，一个自包含的离线生存电脑，让知识和工具永远伴随着你！

什么是 Project N.O.M.A.D.?#

Project N.O.M.A.D.（Node for Offline Media, Archives, and Data）是一个自包含的、离线优先的知识和教育服务器，它打包了关键工具、知识和 AI，让你在任何时间、任何地点都能获得信息和支持。

简单来说，它是一个便携式的数字生存工具箱，即使在没有互联网的情况下，也能为你提供丰富的知识和实用工具。

核心功能介绍#

1️⃣ AI 聊天与知识库#

本地 AI 聊天：由 Ollama 驱动的本地 AI 聊天，支持文档上传和语义搜索（通过 Qdrant 实现 RAG）。即使离线，也能获取智能问答服务。

2️⃣ 信息库#

离线维基百科：通过 Kiwix 提供离线维基百科、医学参考资料、生存指南和电子书。无需网络，随时查阅各种知识。

3️⃣ 教育平台#

Khan Academy 课程：通过 Kolibri 提供 Khan Academy 课程，支持进度跟踪和多用户支持。即使在野外，也能继续学习。

4️⃣ 离线地图#

可下载区域地图：通过 ProtoMaps 提供可下载的区域地图，支持搜索和导航。在没有网络的情况下，也不会迷路。

5️⃣ 数据工具#

CyberChef：提供加密、编码、哈希和数据分析工具。保护你的数据安全，处理各种数据问题。

6️⃣ 笔记功能#

FlatNotes：本地笔记功能，支持 Markdown 格式。记录重要信息，整理思路。

7️⃣ 系统基准测试#

内置基准测试：硬件评分，支持 Builder Tags 和社区排行榜。了解你的设备性能。

8️⃣ 简易设置向导#

引导式首次配置：带有精选内容集合的引导式首次配置。轻松上手，快速设置。

技术原理#

N.O.M.A.D. 是一个管理 UI（“Command Center”）和 API，通过 Docker 编排一组容器化工具和资源。它处理所有内容的安装、配置和更新，让你无需手动操作。

安装方法#

快速安装（仅 Debian 系统）#

在终端中运行以下命令：

Terminal window

1
sudo apt-get update && sudo apt-get install -y curl && curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/install_nomad.sh -o install_nomad.sh && sudo bash install_nomad.sh

安装完成后，打开浏览器并导航到 http://localhost:8080（或 http://设备IP:8080）开始探索！

高级安装#

对于更高级的用户，可以复制 Docker Compose 模板到 docker-compose.yml 文件中，根据自己的喜好进行定制，然后运行 docker compose up -d 启动 Command Center 及其依赖项。

硬件要求#

最低配置#

处理器：2 GHz 双核处理器或更好
内存：4GB 系统内存
存储：至少 5 GB 可用磁盘空间
操作系统：基于 Debian 的系统（推荐 Ubuntu）
网络：稳定的互联网连接（仅在安装期间需要）

关于互联网使用和隐私#

Project N.O.M.A.D. 设计用于离线使用。互联网连接仅在初始安装期间（下载依赖项）和你（用户）决定以后下载其他工具和资源时需要。否则，N.O.M.A.D. 不需要互联网连接，并且零内置遥测，保护你的隐私。

应用场景#

1️⃣ 户外活动#

徒步旅行：离线地图导航，野外生存知识查阅
露营：获取天气信息，急救知识，烹饪指南
探险：地理信息，应急联系方式

2️⃣ 紧急情况#

自然灾害：应急指南，救援信息，医疗知识
网络中断：保持信息访问，通信工具
偏远地区：获取教育资源，技术文档

3️⃣ 教育与学习#

偏远地区教育：离线 Khan Academy 课程
自学：丰富的知识库，AI 辅助学习
技能培训：生存技能，技术教程

4️⃣ 数字安全#

离线数据处理：本地加密，数据安全
隐私保护：零遥测，数据不离开设备

为什么选择 Project N.O.M.A.D.?#

完全离线：不依赖互联网，随时随地可用
功能丰富：集成了多种实用工具和资源
易于安装：一键安装脚本，快速部署
高度可定制：可根据需要添加或删除工具
隐私保护：零内置遥测，数据本地存储
持续更新：定期添加新功能和资源

总结#

Project N.O.M.A.D. 是一个革命性的离线生存电脑项目，它将关键知识和工具打包在一起，让你在任何情况下都能保持信息获取能力。无论是户外探险、紧急情况还是偏远地区工作，它都能成为你的数字生存伙伴。

如果你是一个户外活动爱好者、生存主义者，或者只是想为紧急情况做准备，Project N.O.M.A.D. 绝对值得尝试！

项目地址#

GitHub 仓库：https://github.com/Crosstalk-Solutions/project-nomad

互动时间#

你觉得 Project N.O.M.A.D. 最适合哪些场景？你会在什么情况下使用它？欢迎在评论区分享你的想法！

如果你觉得这篇文章有用，别忘了点赞、在看并分享给喜欢户外活动的朋友们～

推荐阅读：

（注：文章部分信息来源于项目官方文档）

【工具】修改wsl安装包实际安装位置

2025-12-23T12:32:13.000Z

前言#

如果你将Ubuntu的文件解压并安装到D盘，但WSL本身仍在C盘，则安装的Ubuntu子系统仍会使用WSL的默认存储路径。在 WSL (Windows Subsystem for Linux) 中，默认情况下安装的 Ubuntu 子系统及其文件存储位置是固定的，但你可以更改 WSL 的安装地址，尤其是对于 WSL 2。下面是如何更改安装地址的步骤。

一、查看安装路径：#

这一步完全可以不用操作，因为一般情况下WSL 的 Linux系统文件存储在 Windows 文件系统的特定位置。默认情况下，WSL 2 使用一个虚拟硬盘（VHD）来存储文件，而 WSL 1 则将文件存储在 Windows 文件系统中。

1. wsl2的安装目录#

WSL 2: WSL 2 使用一个虚拟硬盘（VHD），存储在 Windows 用户目录下，路径类似于：C:\Users\\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_\LocalState\ext4.vhdx

2. wsl1的安装目录#

WSL 1: WSL 1 的文件存储在 Windows 文件系统的目录下，路径类似于：C:\Users\\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_\LocalState\rootfs

二、操作步骤#

1.查看wsl版本#

你可以运行以下命令来查看你使用的是 WSL 1 还是 WSL 2：（打开powershell以管理员身份运行）

1
wsl -l -v

列出所有已安装的 WSL 发行版及其版本信息：（VERSION显示2，说明是wsl2）

image-20250324142307183

2.更改wsl2的安装位置#

为了将 WSL 2 的安装位置从 C 盘移动到 D 盘，你可以按照以下步骤操作：

1. 创建目标目录#

打开 PowerShell，并运行（以管理员身份运行）以下命令来创建一个目录

Terminal window

1
base mkdir D:\WSL\backup

2. 确认路径权限#

确保你有权限在 D 盘上创建和写入文件。通过尝试在目标路径创建一个测试文件来确认权限：

Terminal window

1
echo "test" > D:\WSL\backup\test.txt

3. 导出当前的 WSL 发行版#

运行以下命令来导出当前的 Ubuntu 发行版：

Terminal window

1
wsl --export openEuler-23.09 E:\WSL\backup\openEuler.tar

这会将当前的 Ubuntu 发行版导出为一个 tar 文件。

4. 注销当前的 WSL 发行版#

运行以下命令来注销当前的 Ubuntu 发行版：

Terminal window

1
wsl --unregister openEuler-23.09

image-20250324143025509

5. 导入 WSL 发行版到新的位置#

运行以下命令将导出的 Ubuntu 发行版导入到 D 盘的新位置：

Terminal window

1
wsl --import openEuler-23.09 E:\WSL\openEuler E:\WSL\backup\openEuler.tar

这会将 Ubuntu 发行版重新安装到 D 盘的 D:\WSL\Ubuntu 目录中。

image-20250324143037588

6. 验证安装#

导入完成后，运行以下命令来验证安装是否成功：

Terminal window

1
wsl -l -v

你应该会看到类似于之前的输出

7. 启动 WSL#

最后，启动 WSL：

Terminal window

1
 wsl -d openEuler-23.09

8. 修改默认启动的系统#

Terminal window

1
# wsl --set-default 
2
# 将替换为你想设置为默认的发行版的名称。例如，如果你想要将Ubuntu设置为默认，你可以使用：
3
wsl --set-default openEuler-23.09

LX Sync Server 部署指南：轻松搭建自己的洛雪音乐服务

2025-12-23T12:32:13.000Z

什么是 LX Sync Server？#

LX Sync Server 是 LX Music 的数据同步与 Web 播放中枢服务，它可以帮你搭建一个私有化的音乐云服务，实现多设备间的音乐数据同步，还能提供在线播放功能。

核心特性#

LX Sync Server 具有以下强大功能：

1. 仪表盘#

提供直观的 Web 界面，实时掌握服务状态与连接数，让你对服务器运行情况一目了然。

2. 用户管理#

支持通过界面快捷添加、删除用户，修改同步密钥，轻松管理多设备连接权限。

3. 数据深度管理#

在线查看所有用户的歌单和歌曲列表
支持搜索与排序，方便快速定位歌曲
支持批量清理冗余数据或删除歌单

4. WebDAV 云端实时同步#

支持坚果云、Nextcloud、Alist 等标准 WebDAV 网盘
支持定时自动将服务器全量数据备份至云端
支持在服务器重置后从云端一键拉回所有数据

5. Web 播放播放器#

支持在线播放音乐
支持自定义播放列表
支持播放进度条、音量控制、播放模式切换等功能
界面和功能与 LX Music 客户端一致，操作简单，不过也是一个空壳儿，需要添加音源文件，小伙伴们需要自己添加（私信小王『音乐』，有惊喜哦）。

今天我就来教大家如何用 Docker 快速部署 LX Sync Server，即使你是技术小白，也能轻松搞定，搭建属于自己的音乐服务！

准备工作#

在开始部署之前，你需要确保你的设备满足以下条件：

安装了 Docker（如果还没安装，可以搜索一下 Docker 安装教程，很简单的）
确保 9527 端口没有被其他服务占用
有足够的存储空间来存放音乐数据

部署方法#

方法一：使用 Docker 命令直接部署#

这是最简单的方法，只需要一条命令就能搞定：

Terminal window

1
docker run -d \
2
  -p 9527:9527 \
3
  -v $(pwd)/data:/server/data \
4
  -v $(pwd)/logs:/server/logs \
5
  --name lx-sync-server \
6
  --restart unless-stopped \
7
  ghcr.io/xcq0607/lxserver:latest

命令解释：

-d：后台运行容器
-p 9527:9527：将容器的 9527 端口映射到主机的 9527 端口
-v $(pwd)/data:/server/data：将容器内的数据目录映射到主机当前目录下的 data 文件夹
-v $(pwd)/logs:/server/logs：将容器内的日志目录映射到主机当前目录下的 logs 文件夹
--name lx-sync-server：给容器起个名字
--restart unless-stopped：容器退出时自动重启
ghcr.io/xcq0607/lxserver:latest：使用最新版本的镜像

方法二：使用 Docker Compose 部署（推荐）#

如果你觉得上面的命令太长，或者想要更方便地管理容器，可以使用 Docker Compose。

新建一个lxsyncserver文件夹，在文件夹中创建一个名为 docker-compose.yml 的文件
将以下内容复制到文件中：

1
version: '3.8'
2
services:
3
  lxserver:
4
    image: ghcr.io/xcq0607/lxserver:latest
5
    container_name: lx-sync-server
6
    restart: unless-stopped
7
    ports:
8
      - "9527:9527"
9
    volumes:
10
      - ./data:/server/data
11
      - ./logs:/server/logs
12
    environment:
13
      - PORT=9527
14
      - FRONTEND_PASSWORD=123456
15
      - DISABLE_TELEMETRY=false

展开收起

Terminal window

1
docker-compose up -d

环境变量说明：

PORT：服务端口，默认 9527
FRONTEND_PASSWORD：前端访问密码，默认 123456
DISABLE_TELEMETRY：是否禁用遥测，默认 false

重要说明：关于挂载卷#

在部署时，有两个挂载卷非常重要：

数据卷：-v ./data:/server/data
- 这个卷存储了所有的应用数据，包括用户信息、认证文件和音乐缓存
- 一定要配置，否则容器重启后数据会丢失
日志卷：-v ./logs:/server/logs
- 这个卷存储了服务的日志文件
- 方便查看服务运行状态和排查问题

验证部署是否成功#

部署完成后，打开浏览器访问 http://你的服务器IP:9527，你应该能看到 LX Sync Server 的登录页面。

默认用户名是 admin，密码是 FRONTEND_PASSWORD（默认 123456），登录后你就可以开始使用了。

访问 Web 播放界面#

除了管理界面，LX Sync Server 还提供了一个 Web 播放界面，你可以通过 http://你的服务器IP:9527/music 访问。

导入音源文件#

点击左边任务栏—设置—系统，我们要在这里添加音乐源，用过lxmusic的朋友都知道，目前这只是一个壳，加入了音乐源才有灵魂。这里要输入管理员密码，输入后才能添加。输入密码后选择你的音源添加就行。【没有音源的朋友可以直接公众号后台回复音乐获取,超多高质量音源】,添加好后就是这样。

管理后台操作指南#

部署完成后，你可以按照以下步骤使用管理后台：

登录管理后台：访问 http://你的服务器IP:9527，默认用户名是 admin，密码是 FRONTEND_PASSWORD（默认 123456），请第一时间更改密码哦！！！
初始化配置：首次登录请立即进入“系统配置”修改默认密码，确保服务器安全
添加用户：在“用户管理”页面创建同步账号，生成的密码即为 LX Music 移动端/桌面端连接时使用的密钥
配置备份策略：建议在“WebDAV 同步”中配置云端备份，双重保障数据安全
管理数据：使用“数据管理”功能查看和管理所有用户的歌单和歌曲
查看快照：在“快照管理”中查看自动生成的备份，必要时可以回滚数据
查看日志：通过“系统日志”功能查看服务器运行状态，排查问题

总结#

通过 Docker 部署 LX Sync Server 非常简单，只需要几个步骤就能完成。部署完成后，你就拥有了一个私有化的音乐同步服务，可以在多设备间同步音乐数据，还能在线播放音乐。

如果你是 LX Music 的用户，或者想要搭建一个自己的音乐云服务，不妨试试 LX Sync Server，相信它会给你带来不错的体验！

项目地址#

GitHub 仓库：https://github.com/XCQ0607/lxserver
官方文档：https://xcq0607.github.io/lxserver/guide/getting-started.html

互动时间#

你有没有使用过类似的音乐同步服务？部署 LX Sync Server 时遇到了什么问题？欢迎在评论区分享你的经验！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边的朋友～

如何把大文件（100M以上）上传到github

2025-12-23T12:32:13.000Z

GitHub 对文件大小有严格限制，普通存储库中单个文件不能超过 100MB，整个存储库建议小于 1GB，强烈建议小于 5GB。以下是处理大文件的常见方法和步骤：

使用 Git LFS 管理大文件#

Git LFS (Large File Storage) 是 Git 的扩展工具，用于管理超出 GitHub 限制的大文件。它通过将大文件存储在仓库外部，仅在仓库中保留引用，从而提高性能和效率。

配置 Git LFS#

安装 Git LFS：

Terminal window

1
git lfs install

跟踪大文件类型：

Terminal window

1
git lfs track "*.ext"

提交 .gitattributes 文件：

Terminal window

1
git add .gitattributes
2

3
git commit -m "Track large files with Git LFS"

添加并提交大文件：

Terminal window

1
git add large_file.ext
2

3
git commit -m "Add large file using Git LFS"

推送到远程仓库：

Terminal window

1
git push origin main

拉取含大文件的仓库#

如果克隆的仓库中没有大文件本体，而是指针文件，可以运行以下命令下载完整文件：

Terminal window

1
git lfs pull

转换历史数据到 LFS#

对于已经提交到仓库中的大文件，可以使用以下命令迁移到 LFS：

Terminal window

1
git lfs migrate import --include="*.ext"
2

3
git push --force

完成后，清理 .git 文件夹：

Terminal window

1
git reflog expire --expire-unreachable=now --all
2

3
git gc --prune=now

使用 GitHub Releases 分发大文件#

如果文件超过 Git LFS 的限制（如单文件超过 2GB），可以通过 GitHub Releases 分发大文件。创建发行版时，可以上传大文件并生成下载链接。

Important

注意事项

Git 不是备份工具。对于超大文件或数据库，建议使用云存储服务（如 Amazon S3、Google Cloud Storage）。
避免外部依赖项膨胀仓库。使用包管理器（如 npm、Maven）管理依赖项。
定期优化仓库大小。使用工具如 git-sizer 分析和管理存储库。

通过以上方法，可以有效管理和分发大文件，避免 GitHub 文件大小限制带来的问题。

【音乐】使用 Cloudflare Tunnel 为nas中的洛雪同步服务开启免费、安全、高速的内网穿透

2025-12-23T12:32:13.000Z

本教程将引导你如何在飞牛（Feiniu）NAS 系统上，通过 Docker 和 Cloudflare Tunnel（也称为 cloudflared）功能，实现免费、安全且无需公网 IP 的内网穿透。这样你就可以在任何地方通过自己的域名访问家中的 NAS 了。

准备工作:

一台正在运行的飞牛 NAS。
一个你自己的域名（例如 yourdomain.com）。
将你的域名托管在 Cloudflare 上。
一个 Cloudflare 账号。

第一步：在飞牛 NAS 中准备 Docker 环境#

首先，我们需要在 NAS 上下载 Cloudflare Tunnel 的官方 Docker 镜像。

登录你的飞牛 NAS 管理后台。
在桌面找到并点击 Docker 图标，进入 Docker 管理器。
在 Docker 管理器左侧菜单中，点击 镜像仓库。
在右上角的搜索框中输入 cloudflared 并搜索。
在搜索结果中，找到官方镜像 cloudflare/cloudflared（通常下载量最大），然后点击右侧的下载图标。
在弹出的“选择标签”窗口中，保持默认的 latest，然后点击确定。系统将开始下载镜像。

第二步：在 Cloudflare 中创建隧道 (Tunnel)#

现在，我们需要登录 Cloudflare 官网来创建一个隧道并获取连接凭证。

登录你的 Cloudflare Dashboard。
在左侧菜单中，找到并点击 Zero Trust。
首次设置 (如果需要)
- 如果你是第一次使用 Zero Trust，系统会要求你设置一个团队名称。这个名称将成为你访问后台的子域名，可以自定义。
- 在选择计划页面，选择左侧的 Free (免费) 套餐。
- 系统可能会要求你添加付款方式，这里有一个技巧可以跳过：直接修改浏览器地址栏的 URL，删除 .com/ 之后的所有内容，然后按回车键重新访问。这样就可以绕过付款验证步骤。
成功进入 Zero Trust 仪表盘后，在左侧菜单中点击 网络 (Access) -> 隧道 (Tunnels)。
点击 创建隧道 (Create a tunnel) 按钮。
在选择连接器类型时，选择 Cloudflared，然后点击 下一步 (Next)。
为你的隧道命名，例如 nas，然后点击 保存隧道 (Save tunnel)。
在“选择您的环境”页面，选择 Docker。页面下方会生成一段 docker run 命令，点击复制图标将这段完整的命令复制下来。这段命令包含了连接隧道的唯一 token，非常关键。

第三步：在飞牛NAS上部署洛雪同步程序#

在 Docker 管理器左侧菜单中，点击 镜像仓库。
在右上角的搜索框中输入 lyswhut/lx-music-sync-server 并搜索，这个镜像为作者的镜像源，也可以自己使用源码构建镜像
在搜索结果中，找到官方镜像 cloudflare/cloudflared（通常下载量最大），然后点击右侧的下载图标。
在弹出的“选择标签”窗口中，保持默认的 latest，然后点击确定。系统将开始下载镜像。

下载完成后，执行以下命令运行容器

Terminal window

1
docker run -d --name lxmusicsyncserver --restart=always -p 19527:9527 -v /vol2/docker/containers/lxmusicsyncserver/logs:/server/logs -v /vol2/docker/containers/lxmusicsyncserver/data:/server/data -e TZ=Asia/Shanghai -e LX_USER_user1=password1   -e BIND_IP=0.0.0.0 -e PORT=9527  lyswhut/lx-music-sync-server

变量名称	说明
`PORT`	绑定的端口号，默认为 `9527`。
`BIND_IP`	绑定的 IP 地址，默认为 `127.0.0.1`，使用 `0.0.0.0` 将接受所有 IPv4 请求，使用 `::` 将接受所有 IP 请求。
`PROXY_HEADER`	代理转发的请求头原始 IP，如果设置，则自动启用。
`CONFIG_PATH`	配置文件路径，默认使用项目目录下的 `config.js`。
`LOG_PATH`	服务日志保存路径，默认保存在服务目录下的 `logs` 文件夹内。
`DATA_PATH`	同步数据保存路径，默认保存在服务目录下的 `data` 文件夹内。
`MAX_SNAPSHOT_NUM`	公共最大备份快照数。
`SERVER_NAME`	同步服务名称。
`LIST_ADD_MUSIC_LOCATION_TYPE`	公共添加歌曲到我的列表时的方式，可用值为 `top` 和 `bottom`。
`LX_USER_`	以 `LX_USER_` 开头的环境变量将被识别为用户配置，可用的配置语法为： 1. `LX_USER_user1='xxx'`； 2. `LX_USER_user1='{"password":"xxx"}'`。其中 `LX_USER_` 会被去掉，剩下的 `user1` 为用户名，`xxx` 为用户密码（连接码）。配置方式 1 为简写模式，只指定用户名及密码（链接码），其他配置使用公共配置。配置方式 2 为 JSON 字符串格式，配置内容参考 `config.js`，由于该方式在变量名指定了用户名，所以 JSON 里的用户名是可选的。

第四步：在飞牛 NAS 上运行隧道并配置路由#

使用 SSH 客户端（如 Windows PowerShell, FinalShell 等）连接到你的飞牛 NAS。
Terminal window
```
1
# 请替换成你自己的端口、用户名和IP
2
ssh -p 22 xxx@192.168.1.92
```
登录后，输入 sudo su 并再次输入密码，切换到 root 管理员用户。
粘贴并执行上一步从 Cloudflare 复制的 docker run 命令。这会首次运行容器并与 Cloudflare 建立连接。看到日志输出后，可以先不用管它。
回到飞牛 NAS 的 Docker 管理界面，在 容器 列表中找到刚刚创建的 cloudflared 容器（通常是随机名称），点击右侧的电源图标，将其停止。
回到 Cloudflare 的隧道配置页面，点击右下角的 下一步 (Next)。
配置公共主机名 (Public Hostname)，这是将你的域名指向 NAS 的关键步骤。
- 子域名 (Subdomain): 输入你想要的前缀，例如 nas。
- 域 (Domain): 从下拉列表中选择你在 Cloudflare 托管的域名。
- 服务 (Service):
  - 类型 (Type): HTTP
  - URL: 输入 http://[你的NAS内网IP]:[端口]，例如 http://192.168.1.92:9527。
点击右下角的 完成设置 (Save tunnel)。

第五步：启动容器并验证访问#

回到飞牛 NAS 的 Docker 管理界面，在容器列表中，重新启动之前停止的那个 cloudflared 容器。
打开一个新的浏览器标签页，输入你刚刚配置的完整域名（例如 https://nas.nas.top）。
你应该能看到飞牛 NAS 的登录界面，并且浏览器地址栏显示的是安全锁（HTTPS 连接），证明内网穿透已经成功！
你还可以尝试在手机上使用移动数据网络访问该域名，同样可以成功登录，证明你可以从任何地方访问你的 NAS。

至此，你的 NAS 内网穿透已全部配置完成！

斩获1.3K star！！超好用的图片处理项目，隐私优先、浏览器端、开源免费，太6了！

2025-12-23T12:32:13.000Z

项目简介#

Mazanoke是一款开源的图片优化工具，它可以在用户的浏览器中运行，无需上传图片至服务器，从而确保了图片的私密性。支持多种图片格式的压缩和转换，比如 JPG、PNG、WebP，甚至还支持 HEIC 和 AVIF 这样的新兴格式。不仅如此，它还能作为渐进式 Web 应用（PWA）安装到桌面或手机上，离线也能用，简直是“随身图片处理厂”！

111

Mazanoke 的界面简洁友好，无论是技术小白还是资深开发者，都能快速上手。你可以调整图片质量、设置目标文件大小、限制最大尺寸，甚至批量处理一堆图片。更贴心的是，它支持从剪贴板直接粘贴图片，省去繁琐的上传步骤。

目前在Github上收获了1.3K star，非常受开发者的欢迎！

image-20250604092518891

性能特色#

灵活优化参数：支持手动调节画质压缩率或指定目标文件大小，系统自动匹配最优压缩方案；可限制图片最大宽高并保持比例缩放，避免画面变形。

全格式转换支持：覆盖 JPG/PNG/WebP 主流格式互转，特别支持 HEIC/AVIF/GIF/SVG 转换为通用格式，轻松适配多设备场景。
三重隐私防护：完全离线运行 + 本地处理无痕迹，自动剥离 EXIF 元数据（含位置、设备信息），杜绝数据上传风险与行为追踪。
极简交互体验：支持拖拽 / 剪贴板粘贴快速上传，参数调整实时预览；可一键安装为桌面应用，离线使用更便捷。
开源自托管优势：遵循 GNU 协议开源，支持 Docker 一键部署私有实例，数据完全自主可控，适配企业与隐私敏感场景。

快速安装使用#

Mazanoke的安装和使用非常简单，用户可以通过以下几种方式快速上手：

1、直接访问官方，网址如下，即可立即体验。

1
https://mazanoke.com

image-20250604092749368

点击右上角的“Install”按钮，就能将 Mazanoke 安装为 PWA，桌面和手机都能用。安装后，它会自动缓存，离线也能正常工作。

image-20250604093727716

2、自托管部署。如果你想完全掌控，推荐自托管！步骤如下：

克隆仓库：git clone https://github.com/civilblur/mazanoke.git
进入目录，打开 index.html 文件，浏览器会直接运行应用。

要是想通过 Docker 部署，可以直接用以下命令：

Terminal window

1
docker run -d -p 3474:80 ghcr.io/civilblur/mazanoke:latest

然后访问 http://localhost:3474 即可。

MAZANOKE 的界面非常简洁明了。在主界面中，你可以通过拖拽或点击上传图片，然后在下方的设置面板中调整图片的质量、大小和格式等参数。下载按钮清晰可见，方便你保存优化后的图片。

深色模式

image-20250604093836936

浅色模式

image-20250604093911266

设置

image-20250604093946831

图片下载

它的操作简单直观，即使是初次使用的用户也能迅速上手。而且，由于所有处理都在本地完成，你无需担心隐私泄露的问题，可以放心地处理个人照片。

小结#

Mazanoke是一款非常出色的图片优化工具，它以其独特的“本地优先”设计理念，为用户提供了一个既方便又安全的图片处理解决方案。无论是普通用户还是专业人士，都可以通过Mazanoke轻松处理图片，满足各种需求。

更多细节功能，感兴趣的可以到项目地址查看：

1
https://github.com/civilblur/mazanoke

微软内部都在用的激活神器！30 秒永久激活 WindowsOffice，小白一看就会

2025-12-23T12:32:13.000Z

✅ 为什么这个工具值得信赖？

开源透明：这是一个 GitHub 开源项目，代码公开可查，确保无病毒无广告，让你使用得放心。

原理合法：它利用的是微软官方激活机制（HWID/KMS），并非破解版，不会涉及版权风险。

全面支持：全面支持 Windows 10/11 全版本以及 Office 2016 - 2021 全系列，适用性极强。

安全放心：该项目获得了 138,000+ Stars 认证，受到全球开发者的共同监督，质量有保障。

🚀 超简单操作步骤（跟着做就行）

在任务栏搜寻Power，选择 “Windows PowerShell,以管理员身份运行” 。

image-20251020134402503

一键下载脚本：复制下面这行代码，粘贴到打开的窗口中：

Terminal window

1
irm https://get.activated.win | iex

然后按 Enter 执行。

image-20251020134520485

image-20251020134556816

选项详解：

1、Windows永久激活

2、Office永久激活

3、Windows激活至2038年

4、Windows/Office 180天循环激活

5、查看激活状态

0、退出

6、7、8、9 这几个选项不常用，可以不用理会。

选1永久激活Windows ,如下画面：

image-20251020134629919

image-20251020134657485

image.png

💡 温馨提示

如遇安全软件拦截，请选择 “允许运行”，以确保脚本能够正常执行。

确保网络连接稳定，以免影响激活过程。

建议激活前重启电脑，关闭其他程序，以避免不必要的干扰。

特别说明：本方法仅推荐用于测试和学习环境，长期使用请支持正版软件哦！

GitHub 15000+ Star！这个工具让 AI 轻松使用任意软件

2025-12-23T12:32:13.000Z

嗨，科技爱好者们！#

最近 GitHub 上又出现了一个爆火的开源项目，短短几天就获得了 8.7k+ Star，甚至后来暴涨到 15000+ Star！它就是由香港大学数据科学实验室(HKUDS)开发的 CLI-Anything。

这个项目的理念非常简单但强大：一条命令，让任意软件直接变成 AI 能用的命令行工具！

什么是 CLI-Anything？#

CLI-Anything 是一个开源项目，其核心目标是构建原生代理软件生态。简单来说，它可以将任何现有的软件通过命令行接口（CLI）暴露给 AI 智能体，让 AI 能够直接操作这些软件。

正如项目的宣传语所说：“今天的软件为人而生，明天的用户是 Agent”。CLI-Anything 正是为了迎接这个未来而诞生的。

核心功能与特点#

1️⃣ 一键转换，简单易用#

CLI-Anything 提供了简单的命令行工具，让你可以轻松地为任何软件创建命令行接口。只需一条命令，就能将图形界面软件转换为 AI 可操作的工具。

2️⃣ 广泛兼容#

无论是什么类型的软件，无论运行在什么平台，CLI-Anything 都能为其创建命令行接口。这意味着 AI 可以操作的软件范围被大大扩展。

3️⃣ 标准化接口#

CLI-Anything 为所有软件提供了标准化的命令行接口，使得 AI 能够以统一的方式与不同软件交互，降低了 AI 学习和使用软件的成本。

4️⃣ 安全可靠#

CLI-Anything 设计了安全的权限管理机制，确保 AI 只能执行被授权的操作，避免了潜在的安全风险。

技术原理#

CLI-Anything 的工作原理主要包括以下几个步骤：

分析软件：识别软件的功能和接口
创建代理：为软件创建命令行代理
暴露接口：将软件功能通过命令行暴露给 AI
接收指令：接收 AI 发送的命令
执行操作：执行相应的软件操作并返回结果

通过这种方式，AI 可以像人类一样使用各种软件，而不需要为每个软件开发专门的接口。

应用场景#

1️⃣ AI 辅助办公#

让 AI 直接操作办公软件，如 Word、Excel、PowerPoint 等，自动完成文档处理、数据分析等任务。

2️⃣ 智能自动化#

通过 AI 控制各种工具软件，实现工作流程的自动化，提高工作效率。

3️⃣ 跨软件协作#

让 AI 协调多个软件之间的工作，实现更复杂的任务处理。

4️⃣ 软件测试与开发#

利用 AI 对软件进行自动化测试，发现潜在问题。

与其他项目的融合#

CLI-Anything 与另一款爆火的开源项目 OpenClaw（308k+ Star）的融合，更是打造了一个强大的 AI 原生软件生态。通过这种融合，AI 可以更加强大、灵活地操作各种软件。

快速开始#

安装#

Terminal window

1
# 克隆项目
2
git clone https://github.com/HKUDS/CLI-Anything.git
3

4
# 进入项目目录
5
cd CLI-Anything
6

7
# 安装依赖
8
# 根据项目文档执行安装命令

基本使用#

Terminal window

1
# 为软件创建命令行接口
2
cli-anything add --name "软件名称" --path "软件路径"
3

4
# 查看已添加的软件
5
cli-anything list
6

7
# 执行软件操作
8
cli-anything run "软件名称" --command "操作命令"

项目愿景#

CLI-Anything 的愿景是构建一个原生代理软件生态，让所有软件都能被 AI 轻松操作。这不仅将改变我们与软件的交互方式，也将为 AI 应用开辟新的可能性。

随着 AI 技术的不断发展，CLI-Anything 这样的工具将变得越来越重要，它为 AI 与现有软件之间架起了一座桥梁，让 AI 能够充分利用人类已经开发的各种软件资源。

总结#

CLI-Anything 是一个非常有创新性的项目，它通过简单而优雅的方式，解决了 AI 与现有软件交互的问题。它的出现，不仅为 AI 应用提供了更多可能性，也为软件行业的发展指明了新的方向。

如果你对 AI 技术和软件自动化感兴趣，不妨尝试一下 CLI-Anything，相信它会给你带来惊喜！

项目地址#

GitHub 仓库：https://github.com/HKUDS/CLI-Anything

互动时间#

你觉得 CLI-Anything 最有潜力的应用场景是什么？欢迎在评论区分享你的想法！

如果你觉得这篇文章有用，别忘了点赞、在看并分享给身边的科技爱好者们～

推荐阅读：

（注：文章部分信息来源于项目官方文档和网络资料）

太牛了！这个免费工具让文件传输比微信还快，再也不用怕大文件发不了了

2025-12-23T12:32:13.000Z

家人们，我发现了一个传文件的神器！#

你们有没有过这样的经历？

想给朋友传个大文件，微信说超过100MB发不了；用QQ传，速度慢得像蜗牛；用网盘，还要上传下载，麻烦死了。

前几天我要给同事传一个2GB的设计文件，试了好几种方法都不行，急得我直跺脚。就在这个时候，朋友给我推荐了一个叫 文件快传 的工具，说是用P2P技术，传文件超级快，而且没有大小限制。我抱着试试看的心态用了一下，结果直接惊到了！

这个工具到底有多神奇？#

1️⃣ 传文件超快，比微信快10倍#

你们知道吗？这个工具用的是WebRTC P2P直连技术，文件直接在两台设备之间传输，不用经过服务器，所以速度超级快。我传那个2GB的设计文件，只用了不到5分钟，比微信快多了！

2️⃣ 没有文件大小限制，想传多大传多大#

不管你要传100MB的视频，还是10GB的电影，都能轻松搞定，再也不用因为文件太大而发愁了。

3️⃣ 安全又隐私，数据不经过服务器#

最让我放心的是，这个工具的数据传输是端到端加密的，而且不经过服务器，也就是说，除了你和接收方，没有人能看到你的文件内容，超级安全！

4️⃣ 功能超级全，不止传文件#

除了传文件，它还能传文字、共享桌面，甚至同步目录，简直是个全能工具！

我的真实使用经历#

前几天我用这个工具给同事传设计文件，操作超级简单：

打开文件快传的网页
点击「选择文件」，选中我要传的设计文件
系统生成了一个6位的取件码
我把取件码发给同事
同事打开同一个网页，输入取件码
开始传输，速度超级快，不到5分钟就传完了

整个过程没有登录，没有注册，不用下载任何软件，打开网页就能用，简直不要太方便！

还有一次，我要给客户演示一个方案，但是客户不在身边，我就用了桌面共享功能，客户输入取件码就能看到我的屏幕，就像面对面演示一样，超级直观！

怎么用这个神器？#

最简单的方法：直接用在线版#

如果你不想麻烦，直接访问在线版就可以用了，不用下载任何东西：

想自己部署？没问题！#

如果你想在自己的服务器或NAS上部署，也超级简单：

Docker一键部署（推荐）#

Terminal window

1
services:
2
  file-transfer-go:
3
    image: matrixseven/file-transfer-go:latest
4
    ports:
5
      - "8080:8080"
6
    restart: unless-stopped

然后打开浏览器访问 http://你的服务器IP:8080 就可以用了。

适合谁用？#

设计师：经常需要传大的设计文件
程序员：传代码、传项目文件
学生党：传作业、传课件、传视频
上班族：传工作文件、演示文稿
任何人：需要传文件的人

其他超实用的功能#

多文件同时传输：一次可以传多个文件，超级方便
断点续传：如果传输过程中网络中断，重新连接后可以继续传，不用从头开始
响应式设计：在手机、平板、电脑上都能完美使用
目录同步：支持整个目录的同步，不用一个一个传文件

总结一下#

文件快传真的是我最近发现的最实用的工具，它解决了我传大文件的困扰，而且速度快、安全、方便，简直是传文件的神器！

如果你也经常需要传文件，尤其是大文件，一定要试试这个工具，相信我，你会爱上它的！

项目地址#

GitHub 仓库：https://github.com/MatrixSeven/file-transfer-go
在线体验：https://transfer.52python.cn/

互动时间#

你们平时传大文件都用什么方法？遇到过什么困扰？用了文件快传后有什么感受？欢迎在评论区分享你的故事！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边需要传文件的朋友们～

JadeAI：AI 驱动的智能简历构建器，让你的简历脱颖而出

2025-12-23T12:32:13.000Z

嗨，职场人们！#

找工作时，一份专业、吸引人的简历是打开职场大门的第一把钥匙。但制作一份优秀的简历往往需要花费大量时间和精力，尤其是在面对不同岗位的 JD 时，需要不断调整和优化。

今天要给你们推荐一个超级好用的工具——JadeAI，一个 AI 驱动的智能简历构建器，让你的简历制作变得简单高效！

什么是 JadeAI？#

JadeAI 是一个开源、免费的 AI 智能简历构建器，它提供了丰富的功能，帮助你轻松创建专业、个性化的简历。无论是刚毕业的学生还是职场老手，都能通过 JadeAI 制作出令人印象深刻的简历。

核心功能介绍#

1️⃣ 直观的简历编辑#

拖拽式编辑器：可视化排列和重新排序简历部分和项目，操作简单直观。

内联编辑：直接在画布上点击任何字段进行编辑，所见即所得。 50+ 专业模板：提供经典、现代、极简、创意、ATS 友好、时间线、北欧、瑞士等多种风格的模板。 主题定制：可自定义颜色、字体、间距和边距，实时预览效果。

编辑历史：支持最多 50 步的撤销/重做操作，不用担心操作失误。

自动保存：可配置保存间隔（0.3s-5s），也支持手动保存。

Markdown 支持：在文本字段中使用 Markdown 语法格式化内容，如粗体、代码、项目符号列表等。

2️⃣ 强大的 AI 功能#

AI 聊天助手：编辑器中集成的会话式 AI，支持多会话和持久历史记录。

AI 简历生成：根据职位、经验和技能生成完整的简历。 简历解析：上传现有的 PDF 或图像，AI 自动提取所有内容。

JD 匹配分析：将简历与职位描述进行比较，提供关键词匹配、ATS 评分和改进建议。 求职信生成：基于简历和 JD 生成 AI 定制的求职信，可选择语气（正式/友好/自信）。

语法和写作检查：检测弱动词、模糊描述和语法问题，返回质量评分。翻译：在保留技术术语的同时，将简历内容翻译成 10 种语言。

灵活的 AI 提供商：支持 OpenAI、Anthropic 和自定义 API 端点，每个用户在应用内配置自己的密钥。

3️⃣ 多格式导出与分享#

多格式导出：PDF（Puppeteer + Chromium）、智能单页 PDF（自动适应单页）、DOCX、HTML、TXT、JSON。 JSON 导入：导入之前导出的 JSON 文件以恢复或创建简历，支持在编辑器中（覆盖当前）和仪表板上（创建新）。

链接分享：基于令牌的可共享链接，可选密码保护。 查看计数器：跟踪共享简历被查看的次数。

4️⃣ 简历管理#

多简历仪表板：网格和列表视图，搜索，排序（按日期、名称）。

从 JSON 导入：直接在仪表板上从 JSON 导出创建新简历。

复制和重命名：快速简历管理操作。

交互式导览：为首次用户提供分步入门指南。

5️⃣ 其他功能#

双语界面：完整的中文（zh）和英文（en）界面。

暗黑模式：支持浅色、深色和系统主题。

灵活的认证：Google OAuth 或浏览器指纹（零配置）。

双数据库：SQLite（默认，零配置）或 PostgreSQL。

快速开始#

Docker 部署（推荐）#

生成密钥

Terminal window

1
# 生成一个随机字符串，用于会话加密。可以使用我的，没啥影响
2
# dACup1/h17qQkOag7wJu7gJBvUgFfrKvAfc+r3kg1HA=
3
openssl rand -base64 32

运行容器

Terminal window

1
docker run -d -p 3000:3000 \
2
  -e AUTH_SECRET=dACup1/h17qQkOag7wJu7gJBvUgFfrKvAfc+r3kg1HA= \
3
  -v jadeai-data:/app/data \
4
  twwch/jadeai:latest

访问应用 打开 http://localhost:3000。数据库在首次启动时会自动迁移和种子。

注意：AUTH_SECRET 是会话加密所必需的。使用 openssl rand -base64 32 生成一个。

AI 配置#

无需服务器端 AI 环境变量。每个用户在应用内的设置 > AI 中配置自己的 API 密钥、基础 URL 和模型。

使用 PostgreSQL#

Terminal window

1
docker run -d -p 3000:3000 \
2
  -e AUTH_SECRET=dACup1/h17qQkOag7wJu7gJBvUgFfrKvAfc+r3kg1HA= \
3
  -e DB_TYPE=postgresql \
4
  -e DATABASE_URL=postgresql://user:pass@host:5432/jadeai \
5
  twwch/jadeai:latest

应用场景#

JadeAI 特别适合以下场景：

求职者：快速创建和优化简历，提高求职成功率
职场人士：更新简历，适应不同岗位的需求
招聘人员：分析简历与职位的匹配度
学生：制作第一份专业简历，迈出职场第一步

为什么选择 JadeAI？#

开源免费：完全开源，免费使用，无隐藏费用
AI 驱动：利用 AI 技术优化简历，提高竞争力
功能丰富：提供从编辑到导出的完整功能
易于部署：一键 Docker 部署，快速开始使用
高度定制：支持多种模板和主题，满足个性化需求
多语言支持：支持中英文界面和多语言翻译

总结#

JadeAI 是一个功能强大、易于使用的 AI 智能简历构建器，它将 AI 技术与简历制作相结合，帮助用户创建专业、有针对性的简历。无论是寻找第一份工作还是寻求职业发展，JadeAI 都能为你提供有力的支持。

如果你正在为简历制作而烦恼，不妨试试 JadeAI，让 AI 帮助你打造一份脱颖而出的简历！

项目地址#

GitHub 仓库：https://github.com/twwch/JadeAI
中文文档：项目仓库中提供

互动时间#

你在制作简历时遇到过哪些困难？JadeAI 能解决你的问题吗？欢迎在评论区分享你的想法！

如果你觉得这篇文章有用，别忘了点赞、在看并分享给正在找工作的朋友们～

推荐阅读：

（注：文章部分信息来源于项目官方文档）

【工具】OpenEuler安装xfce桌面及远程桌面软件xrdp

2025-12-23T12:32:13.000Z

1.更新软件源#

1
dnf update

安装字库

1
dnf install dejavu-fonts liberation-fonts gnu-*-fonts google-*-fonts

安装 Xorg

1
dnf install xorg-*

2.安装 xfce#

1
dnf install xfwm4 xfdesktop xfce4-* xfce4-*-plugin network-manager-applet *fonts

安装登录管理器

1
dnf install lightdm lightdm-gtk

image-20250324143755795

设置默认桌面为XFCE 通过root权限用户设置

1
echo 'user-session=xfce' >> /etc/lightdm/lightdm.conf.d/60-lightdm-gtk-greeter.conf

使用登录管理器登录XFCE

1
systemctl start lightdm

登录管理器启动后，在右上角左侧选择”xfce-session” 输入用户名、密码登录

设置开机自启动图形界面

1
systemctl enable lightdm
2
systemctl set-default graphical.target

如果默认安装了gdm，建议停用gdm

1
systemctl disable gdm

重启验证

1
reboot

登录界面是黑色的是因为lightdm-gtk默认配置文件/etc/lightdm/lightdm-gtk-greeter.conf中没有设置background。可以在该配置文件最后的[greeter]段中设置 background=/usr/share/backgrounds/xfce/xfce-blue.jpg 然后systemctl restart lightdm 就可以看到背景了。

3.安装远程连接软件 xrdp#

1
wget https://mirrors.aliyun.com/epel/epel-release-latest-8.noarch.rpm
2
rpm -ivh epel-release-latest-8.noarch.rpm --nodeps
3
yum -y install xrdp
4
# sed -i 's/port=3389/port=3390/g' /etc/xrdp/xrdp.ini
5
sed -i 's/max_bpp=32/max_bpp=24/g' /etc/xrdp/xrdp.ini
6
touch .xsession
7
echo xfce4-session > /root/.xsession
8
chmod +x /root/.xsession
9
systemctl restart xrdp && systemctl enable xrdp
10
rm -rf /etc/yum.repos.d/epel*

4.防火墙#

1
# 可能需要的其他操作:
2
# 关闭防火墙
3

4
systemctl stop firewalld.service  #临时关闭
5
systemctl disable firewalld.servie #永久关闭
6

7
# 开放端口
8

9
firewall-cmd --permanent --zone=public --add-port=3389/tcp
10
firewall-cmd --reload

Windows 桌面全新体验！Seelen-UI 让你的电脑界面美到窒息，完全自定义

2025-11-23T12:32:13.000Z

朋友们！Windows 桌面也能变得这么好看？#

前几天我发现了一个超棒的 Windows 桌面自定义工具——Seelen-UI，它能让你的 Windows 10/11 桌面变得超级美观，而且完全可以按照你的喜好自定义！

今天我就来给大家介绍一下这个神器，让你的电脑桌面焕然一新！

什么是 Seelen-UI？#

Seelen-UI 是一个完全可自定义的 Windows 桌面环境，它使用 Rust + Tauri 作为后端，TypeScript + React/Preact 作为前端，提供了一套全新的桌面交互体验。

为什么推荐 Seelen-UI？#

1️⃣ 完全可自定义#

Seelen-UI 允许你完全自定义桌面环境，包括：

桌面图标样式
任务栏外观
窗口管理
主题颜色
动画效果

2️⃣ 现代美观的界面#

Seelen-UI 采用了现代的设计风格，界面美观流畅，给人一种全新的视觉体验。

3️⃣ 强大的功能#

Seelen-UI 提供了很多实用的功能：

SeelenWeg：类似 Dock 或 Taskbar 的功能，可以快速访问常用应用
应用分组：可以将多个应用分组到一个项目中
实时应用标题变化：实时显示应用标题的变化
UWP 应用支持：支持 Windows 通用应用
网络图标支持：正确显示网络连接状态

4️⃣ 性能优秀#

由于使用了 Rust 作为后端，Seelen-UI 运行速度快，占用资源少，不会影响系统性能。

5️⃣ 易于安装#

Seelen-UI 可以通过 winget 命令快速安装，非常方便。

如何安装 Seelen-UI？#

方法一：使用 winget 安装（推荐）#

打开命令提示符或 PowerShell
输入以下命令：
```
1
winget install --id Seelen.SeelenUI
```
等待安装完成
启动 Seelen-UI

方法二：从 GitHub 下载安装#

访问 Seelen-UI 的 GitHub 仓库：https://github.com/eythaann/Seelen-UI
下载最新的安装包
运行安装包进行安装
启动 Seelen-UI

如何使用 Seelen-UI？#

1. 基本设置#

启动 Seelen-UI 后，会自动替换默认的桌面环境
你可以通过右键点击桌面或任务栏，进入设置界面
在设置界面中，你可以调整各种外观和行为选项

2. 使用 SeelenWeg#

SeelenWeg 是一个类似 Dock 的功能，可以快速访问常用应用
你可以将常用应用拖放到 SeelenWeg 上
可以通过右键点击应用，进行分组或其他操作

3. 自定义主题#

在设置界面中，你可以选择或创建自定义主题
可以调整颜色、字体、图标等各种视觉元素
可以导入或导出主题，与他人分享你的设计

我的使用体验#

使用 Seelen-UI 后，我的 Windows 桌面焕然一新，感觉就像换了一台新电脑：

界面美观：现代的设计风格，流畅的动画效果，让桌面看起来非常专业
操作便捷：SeelenWeg 让我可以快速访问常用应用，提高了工作效率
完全自定义：我可以按照自己的喜好调整各种设置，打造属于自己的桌面环境
性能优秀：运行流畅，没有明显的卡顿或资源占用

适合谁用？#

桌面美化爱好者：喜欢自定义桌面外观的用户
效率追求者：希望通过优化桌面环境提高工作效率的用户
Windows 用户：想要给 Windows 桌面带来新鲜体验的用户
开发者：对桌面环境开发感兴趣的开发者

项目地址#

如果你对 Seelen-UI 感兴趣，可以访问它的 GitHub 仓库：https://github.com/eythaann/Seelen-UI

互动时间#

你们平时喜欢什么样的桌面环境？使用 Seelen-UI 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

Windows设置exe或者bat文件开机启动的几种方法

2025-11-23T12:32:13.000Z

1.前言#

Windows设置开机启动的办法有很多种，这里简单总结一下，方便备查。

2 启动路径方式#

2.1 将快捷方式放入系统启动路径#

首先 Windows+R 打开运行窗口

Windows+R

然后输入 shell startup

shell startup

打开的路径是：C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

image-20250725091045714

2.2 将快捷方式放入用户启动路径#

首先 Windows+R 打开运行窗口

Windows+R

然后输入 shell

shell

打开的路径是：C:\Users\用户名\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

C:\Users\用户名\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

image-20250725091142389

2 任务计划程序方式#

image-20250725091329980

image-20250725091408644

3 组策略方式#

gpedit.msc

image-20250725091536118

image-20250725091515309

4 注册表方式#

regedit

image-20250725091607407

4.1 用户启动项路径#

计算机\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

4.2 系统启动项路径1#

计算机\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run

4.3 系统启动项路径2#

计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run

4.4 设置exe或者bat的路径#

在这里插入图片描述

5 创建Windows服务方式#

image-20250725091643721

5.1 创建服务#

sc create ServiceName binPath= D:\Debug\authSender.exe start= auto

5.2 删除服务#

sc delete ServiceName

部分机器使用这两个命令并不生效，本人就遇到过，读者可以使用其他几种方式进行设置，不能再一棵树上吊死。

6 总结#

都是些没有什么技术含量的操作，也没什么好总结的，哈哈，都是常规操作，每种方式操作都很简单，不懂的话百度一下，都有说明。回见~

SSL证书转换：cer转jks，pfx转jks

2025-11-23T12:32:13.000Z

快捷操作#

进入jdk相应的目录使用keytool工具：

Terminal window

1
cd C:\Program Files\Java\jdk1.8.0_101\bin

pfx转换为jks命令：

Terminal window

1
keytool -importkeystore -srckeystore "D:\aaa\test\client.pfx" -srcstoretype pkcs12 -destkeystore "D:\aaa\test\client.jks" -deststoretype JKS

cer转jks命令：

Terminal window

1
keytool -import -alias mycert1 -file "D:\aaa\test\root.cer" -keystore "D:\aaa\test\root.jks"

详细说明#

在 Java 环境中，将 .cer 文件转换为 .jks 是配置 SSL 和安全通信的重要步骤。以下是使用 keytool 工具完成此任务的具体方法。

步骤 1: 确保环境准备#

确保已安装 JDK，并将其 bin 目录添加到系统路径中。
确保 .cer 文件已正确下载并可用。

步骤 2: 使用 keytool 导入证书#

运行以下命令将 .cer 文件导入到 .jks 密钥库中：

Terminal window

1
keytool -import -alias <别名> -file <路径/证书名.cer> -keystore <路径/密钥库名.jks>

示例：

Terminal window

1
keytool -import -alias mycert -file "D:\certificates\root.cer" -keystore "D:\certificates\root.jks"

-alias：为证书指定一个唯一别名（如 mycert）。
-file：指定 .cer 文件的路径。
-keystore：指定目标 .jks 文件的路径。如果文件不存在，命令会自动创建。

步骤 3: 验证转换结果#

输入密钥库密码（如果是新建密钥库，则设置一个新密码）。
成功导入后，运行以下命令查看密钥库内容：

Terminal window

1
keytool -list -keystore <路径/密钥库名.jks>

注意事项#

如果需要将多个 .cer 文件导入同一个 .jks，请确保每个证书使用不同的别名。
密钥库密码应妥善保存，以便后续使用。

通过以上步骤，您可以轻松将 .cer 文件转换为 .jks 格式，用于 Java 应用程序的 SSL 配置。

windows Shell 窗口美化

2025-11-23T12:32:13.000Z

一、工具准备和参考文档#

1.工具准备#

WindowsTerminal：本次配置的终端工具，当然也可将本文作为参考
WSL2：Windows Linux子系统

2.参考文档#

Microsoft官方教程：教程：使用 Oh My Posh 为 PowerShell 或 WSL 设置自定义提示符
oh-my-posh官方教程：oh-my-posh

二、WindowsTerminal的基础设置(必做步骤)#

1.字体设置#

首先去 Github 下载 nerd-fonts 字体。字体设置的目的是为了保证在安装了 oh-my-posh 后不产生特殊字符显示的问题。

下载releases的FiraCode.zip：FiraCode3.3.0.zip 其他版本可自行下载。下载完成后解压、安装字体。

在WindowsTerminal 中设置字体：

2.设置WindowsTerminal背景美化(可选)#

三、PowerShell命令行美化#

提示：请提前以管理员身份运行 PowerShell

1. 安装 Powershell 7#

相比于 Windows 默认提供的 Powershell，Powershell 7 拥有以下几个优势：

支持跨平台使用，增强了其灵活性和适用范围。
提供了更优越的性能表现。
处于持续更新状态，保证了功能的不断完善和安全性的提升。

简而言之，Powershell 7 是 Powershell 的升级版。

官网地址：

PowerShell 文档 - PowerShell

Github 地址：

https://github.com/PowerShell/PowerShell

下载地址：

2.安装 Terminal（终端）#

从 微软商店（Microsoft Store） 当中安装即可。

安装地址（懒得搜点这里的链接）：Windows Terminal - Microsoft Apps

img

3. 安装 Oh my posh#

如上，从微软商店安装。安装地址（懒得搜点这里的链接）：oh-my-posh - Microsoft Apps

img

4 安装字体#

由于 Oh My Posh 的众多主题广泛应用了各式图标，但并非所有字体都对这类图标提供支持，导致显示可能出现问题。

官方推荐使用Meslo LGM NF字体以获得最佳体验，可通过点击上述链接下载并安装该字体。此外，如果想尝试更多种的 NF 字体，可以进下面链接查看更多种的。

Nerd Fonts - Iconic font aggregator, glyphs/icons collection, & fonts patcher

我个人，比较喜欢使用 JetBrainsMono Nerd Font，因为日常写 Python 需要使用 PyCharm，所以这个字体看习惯了，也不想使用其他字体了~

img

5. 配置#

1. 创建 Powershell 7 的配置文件#

输入如下命令，下面的命令会先检查配置文件存不存在，如果不存在才创建：

Terminal window

1
if (-not (Test-Path $PROFILE)) {
2
    New-Item -Path $PROFILE -Type File -Force
3
}

接下来，打开配置文件（以下示例展示的是使用记事本进行操作）。

Terminal window

1
notepad $PROFILE

2. 输入 Oh my posh 的配置#

在打开的文件中输入如下命令：

Terminal window

1
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH/half-life.omp.json" | Invoke-Expression

这意味着每次启动 PowerShell 时，都会自动执行上述命令。该命令中引用的 JSON 文件是 Oh My Posh 的主题配置文件。

Oh My Posh 内置了众多主题，大家可以根据个人偏好选择喜爱的一款。如果想浏览所有预设主题的样式，可通过下方链接进行查看：

Themes | Oh My Posh

完成以上步骤后，将获得一个初步美化过的 Terminal 界面：

image-20250908114550498

6 常见错误#

错误1 ，在编辑好5.2 后重新打开终端出现一下错误
image-20250908114904303

解决方法：

执行 set-executionpolicy remotesigned

如果无异常字符出现，则设置成功。如果有以下提示，则按照步骤3执行

1
set-executionpolicy : windows powershell 已成功更新你的执行策略，但在更具体的作业域中定义的策略覆盖了该设置。由于发生覆盖，你的外壳程序将保留其当前的有效执行策略 bypass。请键入“get-executionpolicy -list”以查看你的执行策略设置。有关详细信息，请参阅“get-help set-executionpolicy”。

查看当前执行策略

首先，使用 get-executionpolicy -list 命令查看当前所有作用域的执行策略。

Terminal window

1
get-executionpolicy -list

输出示例：

Terminal window

1
Scope ExecutionPolicy
2
----- ---------------
3
MachinePolicy Undefined
4
UserPolicy Undefined
5
Process Undefined
6
CurrentUser Restricted
7
LocalMachine RemoteSigned

设置特定作用域的执行策略

Terminal window

1
set-executionpolicy remotesigned -scope currentuser

验证设置是否成功

Terminal window

1
get-executionpolicy -scope currentuser

输出应为 RemoteSigned，表示设置成功。

Terminal window

1
wangbin in C:\Users λ get-executionpolicy -list
2
        Scope ExecutionPolicy
3
        ----- ---------------
4
MachinePolicy       Undefined
5
   UserPolicy       Undefined
6
      Process       Undefined
7
  CurrentUser    RemoteSigned
8
 LocalMachine    RemoteSigned

扩展#

1. 安装Git扩展#

posh-git 是一款专为 Windows 系统的 PowerShell 设计的 Git 扩展模块。它的主要目标是在 PowerShell 中提供更为友好、直观的 Git 命令行界面，通过整合 Git 相关的信息到命令提示符中，并提供方便快捷的键绑定，使得日常 Git 操作更为高效、直观。

安装

1
Install-Module -Name posh-git -Scope CurrentUser

安装完成后，重启 PowerShell 并输入以下命令启用 posh-git：Import-Module posh-git

不生效的话可以在前面的配置文件 Microsoft.PowerShell_profile.ps1中追加以下内容

1
Import-Module posh-git # 引入 posh-git

2.历史命令联想#

oh-my-zsh 有一个很便利的功能就是输入部分命令后、按 ↑ 或 ↓ 就可以联想历史的完整命令，其实在 oh-my-posh 中也能实现。

首先在 PowerShell 执行以下命令安装插件：

Terminal window

1
Install-Module -Name PowerShellGet -Force
2
Install-Module PSReadLine -AllowPrerelease -Force

然后修改前面的配置文件 Microsoft.PowerShell_profile.ps1，在末尾追加以下内容：

Terminal window

1
Import-Module PSReadLine # 历史命令联想
2

3
# 设置预测文本来源为历史记录
4
Set-PSReadLineOption -PredictionSource History
5
# 设置 Tab 为菜单补全和 Intellisense
6
Set-PSReadLineKeyHandler -Key "Tab" -Function MenuComplete
7
# 每次回溯输入历史，光标定位于输入内容末尾
8
Set-PSReadLineOption -HistorySearchCursorMovesToEnd
9
# 设置向上键为后向搜索历史记录
10
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
11
# 设置向下键为前向搜索历史纪录
12
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward

3. 卸载#

Terminal window

1
Uninstall-Module oh-my-posh -AllVersions

CMD终端使用oh-my-posh#

首先，安装clink工具，双击exe安装包即可安装

PS: 请记住 clink 的安装目录，下一步会用到~

然后，进入 clink 安装目录，创建 oh-my-posh.lua 文件，添加如下内容：

Terminal window

1
load(io.popen('oh-my-posh init cmd'):read("*a"))()

或者用你自己设置的主题不用默认的

Terminal window

1
# "$env:POSH_THEMES_PATH/half-life.omp.json"
2
load(io.popen('oh-my-posh init cmd --config C:\\Users\\用户名替换\\AppData\\Local\\Programs\\oh-my-posh\\themes\\half-life.omp.json'):read("*a"))()

WSL命令行美化#

本次以 wsl-ubuntu22.04 版本进行演示

1.安装 homebrew 包管理器#

如果不想使用 homebrew ，可以使用oh-my-posh官网提供的手动安装方式 ,这里我就演示 homebrew 的安装

下载并安装

Terminal window

1
# 安装 Homebrew 所需环境
2
sudo apt-get install build-essential procps curl file git
3
# Homebrew
4
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
5
# 重启WSL，输入 brew 查看命令是否能正常运行
6
brew

2.安装 on my posh#

安装

Terminal window

1
brew install jandedobbeleer/oh-my-posh/oh-my-posh

安装完成后可以执行 oh-my-posh get shell 查看当前终端类型，如果出现 Segmentation fault 提示，表示安装 on my posh 出现问题，请检查步骤二，重启WSL或者尝试手动安装。

3.选择主题#

注意哈这里你得灵活一点，找到 oh-my-posh 的安装目录,不要照抄

查看 on-my-posh 的安装目录

Terminal window

1
# 通过该命令可以跳转到 oh-my-posh 安装目录
2
cd $(brew --prefix oh-my-posh)
3
# 输入 pwd 查看当前目录的路径
4
pwd
5
# 输入 ll 查看当前目录下的内容
6
ll
7
# 应该可以看到 themes 目录

拷贝 themes 文件夹

Terminal window

1
# 先将 主题文件夹 拷贝至 家目录 /home/{username}
2
# 注意哈，拷贝的目标文件夹后面会用到的，这里我放在家目录的themes文件夹下
3
cp -r /home/linuxbrew/.linuxbrew/opt/oh-my-posh/themes ~/themes

添加主题，这里可以先看下第五步的说明，将如下代码添加到 ~/.bashrc ~/.profile ~/.bash_profile 三个文件的其中之一的结尾，哪个有效果就是哪个，一个个试

Terminal window

1
# 注意 ~/ 后面要写你拷贝后 {themes} 的目录，我这里就是~/themes，jandedobbeleer可以换成你喜欢的主题名称例如 wholespace
2
eval "$(oh-my-posh init bash --config ~/themes/wholespace.omp.json)"

使用体验#

优点
- oh-my-posh 总体还不错，能够方便的展示 git 相关的信息
缺点
- 性能拉跨，每次终端可能需要0.5s到2s之间的延迟卡顿，相比于 linux 上的 shell 要慢不少

有就行了，要啥自行车~

Dify应用实战(14) - 结果聚合

2025-07-23T12:32:13.000Z

今天我们要学习工作流中对于多路分支进行结果上的合并。

学习完成，你将进一步简化工作流的重复节点，拆分场景后，将其合并到主流程中。

01.动手做一做#

今天的任务基于”医小助”。之前我们先对用户的输入，进行了问题分类。将用户提问，转变为是否为”发热”和”眼科”或者其他的分类之后，再进行处理。

为了提高对问题识别的准确性，我们将进一步使用RAG的方法，对分诊的规范文档的知识进行查询后，再使用LLM进行识别和回答。

图片

但是如果按照之前的工作流，后面会分别接两个相同的”LLM”节点。我们希望对此进行优化，就需要用到今天的主题”变量聚合器”。

因此在”知识检索”和”LLM”节点之间，添加一个新的节点”变量聚合器”。

图片

接着删除第二个”知识检索”和”LLM”节点之间的连线，然后连接第二个”知识检索”和”变量聚合器”节点。最后按下图进行设置

图片

保存后，进行测试。

图片

02.补充说明#

变量聚合节点是工作流程中的一个关键节点，它负责整合不同分支的输出结果，确保无论哪个分支被执行，其结果都能通过一个统一的变量来引用和访问。这在多分支的情况下非常有用，可将不同分支下相同作用的变量映射为一个输出变量，避免下游节点重复定义。
它跟问题分类器正好相反，一个是从一个节点拆分成多个分支，另一个则是把多个分支聚合到一个节点。除了对问题分类器后的workflow做聚合，它还可以对前面学的分支条件做多路聚合。
但是需要注意的是，它本身是支持聚合多种数据类型的，但同一时间却只能聚合同一种数据类型的变量，否则会出现类型不匹配。

如果各个分支上的结果格式不一样，那需要利用模版，或者代码做一下转换，确保类型的一致后，就可以继续用了。

总结

今天学习一个新的组件”变量聚合器”，有了它在AI应用开发中，能合并各种分支条件，以达到”条条大路通罗马”的效果。

大模型的得力干将MCP(4) - 开发客户端

2025-07-23T12:32:13.000Z

今天我们将继续学习，将了解MCP服务的SSE通信的客户端编写。当完成之后，就可以连接上节课的SSE服务了。

等系列课学习完成，你将能了解什么是MCP，如何开发MCP和如何实际使用它（当然我们会回归到Dify中，配合LLM，更加完善我们的AI应用适用场景）。

01.动手做一做#

我们再来复习一下协议的架构。

图片

我们看到Client和Server之间是MCP Protocol通讯的，但是我们已经用了两篇文章来解释服务端开发，显然他们一个是stdio，另一个是SSE，是不一样的。

因此，Client必然是有差异的，今天我们就来看看如何实现目标。

同样从TypeScript的SDK开始，来写一个Client(SSE通信方式)。

在目录下新建一个client.ts文件，引用SDK的client和sse，其余代码见下图。

图片

代码不多，仅作演示。谜题揭晓，SSE的服务需要用SSEClientTransport去连接。而本地stdio服务，就需要用StdioServerTransport去连接。目前大部分助手类工具都是用的stdio的方式。这里卖个关子，在Dify应用中，会讲如何更好的使用MCP。

02.测试说明#

通过编译得到sse.js和client.js，启动两个命令行窗口，并分别运行如下命令：

1
//第一个窗口运行
2
node dist\sse.js
3

4
//第二个窗口运行
5
node dist\client.js

如果client窗口运行报错，出现”Error: EventSource is not defined”。请修改引用库@modelcontextprotocal\sdk库下dist\client\sse.js，在文件第一行插入以下代码。

1
import { EventSource } from 'eventsource';

再为项目添加依赖库eventsource。

1
npm install eventsource

原因在于SSE通常运行在浏览器里，在node环境下默认是没有的，所以需要手动添加。

这样，就完成了基于SSE的MCP Client的编写(当然这个Client有点简单，只列举了MCP服务端支持的tools)。

此时第一个运行SSE服务端的窗口，出现了Connection和Message的日志。

图片

重点是看第二个窗口的输出，可以看到服务端的工具已经都获取到了。

图片

03.补充说明#

上节课所说的完整，就是今天的客户端补齐。对于MCP中最核心的概念，应该算都涉及了。作为开发者，应该就能依葫芦画瓢了。

正如麦金叔说的MCP是新兴的协议，所以对于入局者来说机遇和挑战并存。通过这段时间麦金叔的测试，不像网上大家说的那么热闹，好多问题还没有解决，是需要社区和开发者共同努力去丰富的。

所以在结束MCP系列之前，麦金叔还将花一篇文章来”画一下大饼”。之后再回归Dify课程中，给大家讲解如何让Dify来用上MCP的能力，这样就闭环了。敬请期待！

总结

今天学习了MCP基于SSE服务的客户端实现。理解同为客户端在stdio和sse通信方式下的代码差异。

Dify应用实战(5) - 使用模版

2025-07-23T12:32:13.000Z

除了语音生成，我们还有几种形态的生成，需要继续完成。今天教大家使用Jinja模版，将内容进行格式输出。
学习完成，你将掌握生成内容时，可以用固定的模版，填入动态变化的内容，来生成文案内容等。

01. 动手做一做#

基于上上一节课的流程，在”代码执行”节点之后，新增一个”模版转换”的节点。

图片

添加之后，连接”代码执行”节点和新增节点，再连接新增节点和结束节点（这里先移除语音输出处理，后面会加回来，要多路生成不同的内容）。新增参数(一定要先连接)“模版转换”的输入，选择”代码执行”的Object。这里注意，需要将”代码执行”节点也做一些调整。

图片

输出的时候，要按字典而非之前的字符串输出。输出变量也选对象输出。
新增节点修改参数，输入模版内容，不变的内容和动态内容分开，动态内容的值需要有双大括号转义。

图片

点击”发布”，保存。提示”操作成功”。就可以进行测试了。测试如下：

图片

结果输出是一个按模版填入动态获取内容的整段文案结果。

02. 补充说明#

今天的任务，也非常简单，但为什么是中级水平呢？原因是，这里的Jinja模版的使用，也需要一定的编程经验。
Jinja原本是Python的模板引擎，最初是为Flask框架开发的，功能非常强大，可以动态生成网页，XML，CSV或者Markdown文本。
所以，在实际项目中，利用模板转换的功能，将中间数据，通过模板渲染成需要的格式，才能体现它真正的威力，千万不要被本文例子中的简单写法迷惑，觉得它过于简单哦。
下面例子展示了循环，判断等处理能力。

1
2
    {% for item in items %}
3
        {% if item.cash %}
4
          小计金额：{{ item.total }}
5
        {% else %}
6
          无需付费。
7
        {% endif %}
8
    {% endfor %}
9

总结

今天在上次的工作流基础上，进一步增加利用模板进行数据的转换处理，可以定制以固定格式呈现的内容，并插入动态值，生成完整的内容。

Dify应用实战(1)-知识库检索

2025-07-23T12:32:13.000Z

从今天开始，我们进入Dify应用开发课程。为了方便小白入门，课程的内容编排是先动手做一做，然后再解释原理。

1. 动手做一做#

进入Dify，选择创建空白应用。

图片

这次我们选择工作流，输入应用名字，点击”创建”。

图片

可以看到一个空白画布，和coze不同。Dify只给出一个开始节点。那我们就点击选择”知识检索”。这时”开始”节点和新增的”知识检索”就链接起来了。右侧配置项，点击”知识库”右边的”+“号，选择创建的知识库。如果此时没有知识库，那应该先去知识库那里，上传一个知识库。

图片

Warning

这里还有一个需要注意的地方，需要给出查询的变量，即从知识库里查询什么内容。如果选的是chatflow，那这里可以直接选sys.query。而我们选的是workflow，就在”开始”节点添加一个变量，例如博主用的是文本类型，变量名称叫input。

接着，继续添加一个LLM节点。此时，模型博主先用qwen2.5<14b>，上下文选择知识检索。

图片

而关键的SYSTEM里面，其实就是系统提示词，填入以下内容：根据用户输入和知识检索的结果，输出用户期望得到的adcode。只需要给出准确的adcode的值，禁止出现 “think” 相关内容。

Warning

注意，因为复制的关系，里面还缺少一些内容。就是在”用户输入”后，需要输入{，这时系统会提示变量，选择”开始”的变量input，而”检索结果”后，也同样输入{，根据系统提示，选择”上下文”。这里一定要按指导操作。

这样就完成流程了，再添加一个”结束”节点。并添加输出变量，选择LLM的text。

图片

点击”发布”，保存。提示”操作成功”。就可以进行测试了。

2. 测试并定位问题#

点击”运行”按钮。

图片

等待流程运行完毕，就能得到结果。

图片

可以看到得到的是我们期望的结果。如果没有得到结果，我们可以通过”追踪”来查询原因。

图片

1
至此一个简单的通过输入地区名，获得对应的adcode的值的流程就完成了。（为了一次讲解一个点，这个流程简化到了极致，实际应用，会继续用这个adcode，进行天气的查询等操作。并将天气预报结果，作为"每日小报应用"的一个模块。）
2

3
一般第一次进行AI应用的开发，不会这么顺利。
4

5
 遇到问题很正常的，麦金叔作为你最大的后盾，只要添加文末助手微信号，就能一对一指导你，并且都是免费的。

3. 原理讲解#

1
现在我们已经完成了最简单的从知识库定向检索内容流程，让大模型不再自由发挥。那这背后的原理是什么呢？
2

3
如果你只想应用，不太想知道内幕细节，那这个章节完全可以跳过忽略了。
4

5
别看上面我们操作就是新增一个知识库，并上传了一个文档，但这背后的原理实现还是很复杂的。感谢无数背后的大佬们的辛苦付出。
6

7
这个过程叫RAG（Retrieval - Augmented Generation），中文意为检索增强生成。它是一种将信息检索与大语言模型（LLM）相结合的技术架构，旨在提升大语言模型回答的准确性、可靠性和时效性。
8

9
简单的原理实际分为四大块：

1 预处理#

**格式转换：**将用户上传的文档，如PDF，WORD，CSV或者Markdown文件，统一转换为文本格式。如是富文本格式，还需要提取文字内容，表格也转化成文本。
**文本清洗：**将上一步得到的文本内容，进一步做处理，删除多余的标签或空格，特殊符号，换行符等。字母也做统一大小写转换，防止查询时的不匹配。
**分词处理：**将文本内容进行分割，如中文按词组做分割等。

2 向量化#

**嵌入模型：**Dify利用预训练的Embedding Model，将经过预处理的内容转换为向量数据。这个过程实际上也是大语言模型的一个分支，但比较专注于词语或者句子的语义向量化表达。
**向量生成：**对于每个文档内的片段或者句子，嵌入模型都会生成对应的向量。这些向量表达了语义关联性，为后续相似度计算提供基础。

3 构建索引#

**向量索引：**为实现高效检索，Dify会通过构建向量索引，来达到查询优化。如使用 HNSW(Hierarchical Navigable Small World)图，能在高维向量空间中快速找到与所要查询的向量最相似的向量结果，极大提高检索效率。
**索引存储：**构建完的索引被存在数据库中，后续使用时，通过查询数据库，获得索引对应的原始文本内容。并有机会通过局部内容的使能，来控制，不想被检索到的内容。

4 查询输出#

**查询向量化：**当用户输入查询内容时，Dify同样使用一致的嵌入模型，将输入内容转为向量表达。通过相似度计算，获得相似的一组结果。
**排序筛选：**对一批查询结果相似度做得分标记，并根据召回策略等进行结果动态筛选。
**文本提取：**根据筛选后的向量结果，提取对应的原始内容，输出返回给用户。

总结#

1
今天在本地的环境上，开始了真正的AI应用开发，并初步体验了第一个核心功能点"知识检索"。这是后续的复杂功能的一个重要的内容，所以一定要练习，并真正运行得到结果。
2

3
同时，我们也简单学习了解了RAG的基本原理和处理过程。通过对外部知识的特供，让RAG为大语言模型提供更准确和专业的信息，避免模型训练用的语料不是针对性的问题。

如果你对AI的发展感兴趣，欢迎一键三连。有任何问题可以扫码添加好友，我们共同探讨。

大模型的得力干将MCP(5) - 应用场景和发展方向，窥探先机，不容错过

2025-07-23T12:32:13.000Z

今天我们不学习，来聊一聊MCP服务的未来。通过前面几期的学习，我们知道使用MCP服务有两种方式。

一、stdio方式，即服务端和客户端在本地一起。#

优点：

1.可以利用现有的助手类工具，如Cursor，VSC+插件，或者最近开源并快速发展的DeepChat。通过搜寻开源的MCP服务，如高德MCP，CloudFlare MCP等。

2.可以使用对本机操作的MCP服务。
缺点：

1.只能1<1绑定客户端>，每个客户端都要重新安装配置一遍。

2.因需要本地运行，依赖本机的运行环境。

二、sse方式，即服务端和客户端逻辑分开，可以不在一台机器上。#

优点：

1.可以在组织内共享服务，真正的服务运行在远端服务器上。

2.降低助手类工具使用门槛。
缺点：

1.增加服务端运维的复杂性。

2.无法对使用者本地机器进行控制。

不同的使用场景，需要使用不同的方式。同时，即使确定某种方式，也还存在落地上的问题。因此为了更好的解决实现和使用上的问题，MCP继续完善协议(大家都有活干了)。我们来看看官方的规划吧！

01.H1Roadmap#

1.Remote MCP Support

目前主流的工具都还是stdio的使用方式，为了满足企业和互联网服务上的需求，这个是第一优先级的事情。

其中提到了认证和授权，服务发现以及无状态。是不是很熟悉，对，没错！互联网那一套依然有用。

CloudFlare给大家打了个样。

图片

2.Distribution & Discovery

主要目标是解决打包分发的标准和类似npm包仓库的服务。通过实现服务注册，来自动发现MCP服务器，减少人手工去添加服务的复杂操作。同时要解决沙箱运行的机制，来避免污染服务运行环境，并提高运行服务所在主机的安全性。

真正投入企业生产应用，安全问题是一个很大的门槛；并且降低普通员工使用的门槛，才是王道。

3.Agent Support

分层代理系统，希望解决当真正投入使用海量MCP服务时，通过命名空间和拓扑感知来更好的管理使用服务。

提供更好的跨代理层级的使用；并可以使用流式处理，来缓解需要长时间运行任务而超时的问题。

以上的规划，目前有些已经完成，但还有很多在路上。

02.一些想法#

有需要才有市场，当AI遇上MCP。一瞬间打开了新世界的大门，原先不知道如何入局AI的公司和个体，都跃跃欲试。为了让AI应用，或者说智能体应用，可以更好的给客户带来价值。能连接原先数字化的世界数据，才是关键。

以下是麦金叔自己感觉有前途的一些方向，请大家结合自己的实际量力而行，如有想法，也欢迎一起交流。

一、助手工具

虽然现在的助手工具非常多，但是一款全面适合MCP的，选择并不多。围绕如何让用户更简单的使用MCP，这里机会还是有很多的。当然，可能也需要配合服务端的实现。

比如，所有MCP是不是只需要一个服务地址(也可以是企业内部一个服务地址)，最多是几个供应商的服务地址。类似与硅基或者火山提供的大模型服务一样，可以自举列出所有MCP的服务，然后只需要点击开启，就可以被大模型直接使用。而不是像现在一样，每个服务都要填入命令，服务名，参数，详细描述等一大堆东西。

再比如，工具能自己封装运行时，不需要再去关心是node，还是python亦或别的语言提供的服务能不能正常运行。

二、服务市场

现在基本上还没有形成MCP的服务市场，mcp.so算是比较早期的形态。

完整的服务市场，除了搜索MCP服务，还应该从客户需求出发，用使用场景上做切入。毕竟客户是来找解决方案的，如果能知道要使用某个具体的MCP，其实已经属于比较后期了，因此这当中就存在很大的鸿沟。如何能缩短差距，就有人买单。

服务市场，需要能提供托管的方案。现在云服务商已经开始进军这一块了。简化MCP服务的部署和运维，让使用者像FasS一样简单，才会焕发出生命力。

三、服务提供商

如果是原先通过API提供互联网服务的厂商，将其封装为MCP服务，便能开辟新的蓝海，让你在新的AI应用爆发期，能快速成长。

再进一步对垂直类做更加智能的扩展，将服务做到极致，便会在新的竞争中利于不败之地。

比如旅行规划，除了提供游览地的路线外，还可以顺带推荐餐饮和住宿，让你可以在促成交这件事上有更大的优势。

又如AI销售服务，自动完成和客户对话的录制，分析，总结，以强化下一次服务的关键点提示等，可以实现更为个性化，精准的销售促成。

四、个体参与者

个体又分应用者和开发者。

前者可以在使用过程中，将常用的服务进行打包。作为一个整体服务提供给其他同业者使用，以获取按使用收费的报酬。

而后者能做的更多。别人不知道或者不愿干的一些整合，封装的工作。可以摇身一变，成为AI助手不可或缺的插件，从而获得丰厚的酬劳。

如果你也有兴趣，一定记得心动不如行动。好的开头，就成功了一半。

总结

今天麦金叔没有给大家讲知识，而是抛砖迎玉，期望粉丝朋友们，都能在新的浪潮中，成为弄潮儿，并收获丰硕的成果。本期过后，麦金叔又将回归Dify系列，让大家继续丰富自己的知识，实实在在的把所学知识用到实际工作中，并在年底能有拿的出手的亮点。

Dify部署及简单应用

2025-07-23T12:32:13.000Z

前提条件#

安装 Dify 之前, 请确保你的机器已满足最低安装要求：

1
CPU >= 2 Core
2
RAM >= 4 GiB

图片

关于如何在各操作系统上安装Docker，可查看Docker官方文档(https://www.docker.com/)

或参考文章：

如何在Linux、Windows、MacOS中安装Docker
蓁心的蓁意，公众号：时光瞭望塔如何在Linux、Windows、MacOS中安装Docker

获取代码#

克隆 Dify 源代码至本地环境。

1
git clone https://github.com/langgenius/dify.git --branch 1.1.3

克隆代码需要系统已装Git，否则需要先安装。

访问 Git 官网，下载安装包安装：https://git-scm.com/downloads

关于Git安装可参考文章：

如何在Linux、Windows、MacOS中安装Git
蓁心的蓁意，公众号：时光瞭望塔如何在Linux、Windows、MacOS中安装Git

如果你的网络环境不好，无法直接克隆完整项目，可以试下以下的命令：

1
# 或者增加缓冲区大小
2
git config --global http.postBuffer 524288000
3
# 浅克隆
4
git clone --depth 1 https://github.com/langgenius/dify.git
5
# 获取所有历史
6
git fetch --unshallow

没有安装Git或者实在无法通过克隆下载的，可以直接压缩包进行解压。

Github 项目地址：https://github.com/langgenius/dify

图片

启动 Dify#

进入 Dify 源代码的 Docker 目录

1
cd dify/docker

复制环境配置文件

1
cp .env.example .env

启动 Docker 容器

根据你系统上的 Docker Compose 版本，选择合适的命令来启动容器。你可以通过 $ docker compose version 命令检查版本，详细说明请参考 Docker 官方文档：

如果版本是 Docker Compose V1，使用以下命令：

1
docker compose up -d

如果版本是 Docker Compose V2，使用以下命令：

1
docker-compose up -d

运行命令后，你应该会看到类似以下的输出，显示所有容器的状态和端口映射：

1
`[+] Running 11/11` `✔ Network docker_ssrf_proxy_network  Created                                                                 0.1s`  `✔ Network docker_default             Created                                                                 0.0s`  `✔ Container docker-redis-1           Started                                                                 2.4s`  `✔ Container docker-ssrf_proxy-1      Started                                                                 2.8s`  `✔ Container docker-sandbox-1         Started                                                                 2.7s`  `✔ Container docker-web-1             Started                                                                 2.7s`  `✔ Container docker-weaviate-1        Started                                                                 2.4s`  `✔ Container docker-db-1              Started                                                                 2.7s`  `✔ Container docker-api-1             Started                                                                 6.5s`  `✔ Container docker-worker-1          Started                                                                 6.4s`  `✔ Container docker-nginx-1           Started                                                                 7.1s`

运行命令后，等待所有服务启动完成，第一次运行需要点时间。最后检查是否所有容器都正常运行：

1
docker compose ps

在这个输出中，你应该可以看到包括 3 个业务服务 api/worker/web，以及 6 个基础组件 weaviate/db/redis/nginx/ssrf_proxy/sandbox 。

1
NAME                  IMAGE                              COMMAND                   SERVICE      CREATED              STATUS                        PORTS
2
docker-api-1          langgenius/dify-api:0.6.13         "/bin/bash /entrypoi…"   api          About a minute ago   Up About a minute             5001/tcp
3
docker-db-1           postgres:15-alpine                 "docker-entrypoint.s…"   db           About a minute ago   Up About a minute (healthy)   5432/tcp
4
docker-nginx-1        nginx:latest                       "sh -c 'cp /docker-e…"   nginx        About a minute ago   Up About a minute             0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp
5
docker-redis-1        redis:6-alpine                     "docker-entrypoint.s…"   redis        About a minute ago   Up About a minute (healthy)   6379/tcp
6
docker-sandbox-1      langgenius/dify-sandbox:0.2.1      "/main"                   sandbox      About a minute ago   Up About a minute
7
docker-ssrf_proxy-1   ubuntu/squid:latest                "sh -c 'cp /docker-e…"   ssrf_proxy   About a minute ago   Up About a minute             3128/tcp
8
docker-weaviate-1     semitechnologies/weaviate:1.19.0   "/bin/weaviate --hos…"   weaviate     About a minute ago   Up About a minute
9
docker-web-1          langgenius/dify-web:0.6.13         "/bin/sh ./entrypoin…"   web          About a minute ago   Up About a minute             3000/tcp
10
docker-worker-1       langgenius/dify-api:0.6.13         "/bin/bash /entrypoi…"   worker       About a minute ago   Up About a minute             5001/tcp

通过这些步骤，你应该可以成功在本地安装Dify。

访问平台#

先前往管理员初始化页面设置设置管理员账户：

# 本地环境

http://localhost/install

# 服务器环境

http://your\_server\_ip/**install**

图片

设置完成后，就可以访问主页面登录了：http://localhost

图片

创建你的第一个 AI 应用#

1. 创建应用#

点击”创建新应用”，选择应用类型

图片

2. 配置应用#

添加模型

模型需要在设置中预先设置好，才可以在应用中选择，如下图：

图片

从”从添加更多模型供应商“中选择需要添加模型，这里我已经选择了通义千问，配置好apiKey之后就可以使用了，关于apiKey的获取，可以去阿里云百炼平台注册申请，前期会有免费额度。这里如果选择DeepSeek模型，apiKey是到DeepSeek官网注册申请，大家按需选择即可。

如下图所示，默认打开了千问下所有模型，我们可以手工关闭不需要的：

图片

回到应用配置页面，右上角选择模型，如下图所示：

图片

关于大模型参数那些，这里不展开描述，后面有机会再开个文章介绍，或者直接看官网。

这里为了演示，我就让大模型帮我生成提示词了，生成一个翻译助手的提示词，让在建的应用帮我们做语言翻译，如下图所示：

图片

3、调试和发布#

可以从下面文章高原英文做测试：

测试文章
RhettLeo，公众号：时光瞭望塔读《The Little Prince》小王子-01

图片

让ai助手翻译上面英文，如下图所示：

图片

可以看到调试结果。调试没问题之后就可以发布应用了，如下图所示：

图片

点击运行，跳转新页面，展示一个聊天对话框，如下图所示：

图片

开始对话：

图片

也可以将应用以iframe嵌入网页、h5中，如下图所示：

图片

4、更新 Dify#

如果开源社区Dify有更新，我们可以按照如下方式进行更新

进入 dify 源代码的 docker 目录，按顺序执行以下命令：

1
`cd dify/docker``docker compose down``git pull origin main``docker compose pull``docker compose up -d`

如果不是git克隆，就需要再重新下载最新代码解压。

同步环境变量配置 (重要！)

如果 .env.example 文件有更新，请务必同步修改你本地的 .env 文件。

检查 .env 文件中的所有配置项，确保它们与你的实际运行环境相匹配。你可能需要将 .env.example 中的新变量添加到 .env 文件中，并更新已更改的任何值。

自定义配置

编辑 .env 文件中的环境变量值。然后重新启动 Dify：

1
`docker compose down``docker compose up -d`

完整的环境变量集合可以在 docker/.env.example 中找到。

以上便是部署Dify的全部过程，如有纰漏，欢迎指正。大家可以参考，部署起来后就可以愉快地玩耍了，可以在自己的环境上验证自己的AI idea，在AI时代，想法很重要，动起来！

参考资料：

Dify官方文档：https://docs.dify.ai/zh-hans/getting-started/install-self-hosted/docker-compose

Dify应用实战(15) - 对象存储

2025-07-23T12:32:13.000Z

今天我们将要开启企业应用之旅，让Dify真正的在企业中用起来。

学习完成，你将能配置后台的文件存储改为S3或兼容S3的Minio对象存储。

01.动手做一做#

今天的动手实验，与运维相关。如果不感兴趣，可以划走。

首先，需要让Dify知道使用对象存储方式来保存文件。

进入到项目下的docker目录，打开由.env.example文件复制而来的.env文件。找到文件存储配置段，大概在第293行，改动STORAGE_TYPE为S3。

图片

S3除了可以是AWS的S3服务，还可以是兼容S3的对象存储，如Minio等。注意这里，如果对象存储服务是Minio，S3_ENDPOINT需要为实际Minio的API地址，S3_BUCKET_NAME可以改为实际用的桶名，如difyai。而ACCESS_KEY和SECRET_KEY，分别是Minio的用户名和密码，并非像S3使用的KEY。

接着，需要重新启动Dify所有服务。使用命令docker compose restart。

如果测试没有生效，可以reload环境变量文件，或者简单点重启Linux服务器。

上述操作完成之后，接下来就是使用部分。

将Chatflow的应用设为允许文件上传，按下图所示步骤进行设置。

图片

02.测试说明#

运行Chatflow应用，开启新的对话，在对话框右侧点击附件，即可上传文件。

图片

去对象存储服务器检查一下，是否文件按预期上传。

图片

在difyai的对象桶里面，能看到已经在upload_files的目录，在其中存在一个文件，但是文件名会被修改为UUID表示的key，如上图所示。

同样，如果创建知识库，并上传文档。部分内容也会处理后存储进对象存储服务中。

总结

今天学习了将Dify服务的文件改为对象存储方式，可以更好的在企业内部满足多人使用的场景。

AiToEarn：AI 驱动的内容增长与变现平台，让创作更有价值！

2025-07-23T12:32:13.000Z

嗨，内容创作者们！#

在这个内容为王的时代，你是否遇到过这些问题：

创作灵感枯竭，不知道该写什么内容
内容发布后效果不佳，缺乏流量
跨平台运营繁琐，管理困难
内容变现渠道单一，收益有限

别担心，今天我要给你们推荐一个全能型内容运营神器——AiToEarn！它是一个全链条的 AI 驱动内容增长与变现平台，让你真正实现「Create · Publish · Engage · Monetize」（创作 · 发布 · 互动 · 变现）。

什么是 AiToEarn？#

AiToEarn 是一个一站式平台，通过 AI 自动化，帮助创作者、品牌与企业在全球主流平台上构建、分发并变现内容。它支持多达 14 个主流内容平台，包括国内的抖音、小红书、视频号、快手、哔哩哔哩、微信公众号，以及国际的 TikTok、YouTube、Facebook、Instagram、Threads、Twitter（X）、Pinterest、LinkedIn。

核心功能介绍#

1️⃣ 内容发布：一键多平台#

全网分发：覆盖最广的平台矩阵，一键将内容同步到多个平台，省去重复操作的烦恼。

智能导入：导入历史内容，快速二次编辑与再分发。例如：一键将你的小红书内容同步到 YouTube。

日历排期：像排日程一样统一规划所有平台的内容，让内容发布更有条理。

2️⃣ 热点灵感：爆款灵感引擎#

案例库：浏览 1 万+ 点赞量级内容的创作方法，学习爆款内容的制作技巧。

趋势雷达：第一时间捕捉热点，缓解创作者焦虑，让你的内容始终紧跟潮流。

3️⃣ 内容搜索：品牌与市场洞察#

品牌监测：实时追踪关于你品牌的讨论，了解市场反馈。

内容发现：按主题、话题与社区检索，以更精准地参与互动，提升品牌影响力。

4️⃣ 评论搜寻：精准用户挖掘#

智能评论检索：识别”求链接""怎么购买”等高转化信号，找到潜在客户。

转化加速器：快速回复，驱动更高互动与销量，提升转化效率。

5️⃣ 互动运营：增长引擎#

统一工作台：在一个界面管理全部互动，提高运营效率。

主动参与：跟进热点话题，连接潜在用户，将被动运营转变为主动引流。

6️⃣ 数据分析：全链路漏斗#

跨平台对比：某个平台限流？其他平台一样能打，全面了解各平台表现。

端到端监控：追踪表现，构建通往 100 万+ 粉丝的路线图，数据驱动增长。

7️⃣ AI 内容创作：端到端助手（即将推出）#

AI 文案：自动生成标题、文案与描述，节省创作时间。

AI 评论：主动互动，吸引流量，提升用户参与度。

图片与卡片生成：加速内容工作流，让内容更具吸引力。

支持多种模型：视频模型（Seedance、Kling、海螺、Veo、Midjourney、Sora、Pika、Runway）和图像模型（GPT、Flux）。

8️⃣ 内容交易市场：创作即变现（即将推出）#

创作者：直接出售你的内容，高效找到买家，实现内容变现。

品牌方：即买即用的优质内容资源，节省内容制作成本。

智能体（Agent）功能#

AiToEarn 还加入了能够自动内容生成和发布的超级 AI 智能 Agent，让智能体帮你创作和发布，辅助你使用 AiToEarn，进一步提升效率。

快速开始#

Docker 部署（推荐）#

这是运行 AiToEarn 最简单的方式，通过一条命令启动前端、后端、MongoDB 和 Redis，无需在机器上手动安装 MongoDB 或 Redis。

Terminal window

1
git clone https://github.com/yikart/AiToEarn.git
2
cd AiToEarn
3
docker compose up -d

访问应用#

Docker 成功启动后，您可以通过以下地址访问服务：

服务	URL	描述
Web 前端	http://localhost:8080	Web 用户界面（通过 Nginx）
后端 API	http://localhost:8080/api	AiToEarn 后端 API（通过 Nginx）
RustFS 控制台	http://localhost:9001	对象存储管理控制台
MongoDB	localhost<27017>	MongoDB 数据库
Redis	localhost<6379>	Redis 缓存

适用场景#

AiToEarn 特别适合以下场景：

内容创作者：提升创作效率，扩大影响力，实现内容变现
品牌方：多平台运营，提升品牌曝光，精准触达目标用户
企业：构建内容营销体系，提升品牌价值
线下商户：通过线上内容推广，获取更多到店流量

总结#

AiToEarn 是一个功能强大的 AI 驱动内容增长与变现平台，它通过自动化和智能化，帮助用户解决内容创作、发布、运营和变现的全流程问题。

无论是个人创作者还是企业品牌，都能从 AiToEarn 中获益。它不仅节省时间和精力，还能提高内容质量和运营效果，让创作更有价值。

预计在 2026 年 4 月份，AiToEarn 会发布全新版本，带来更多强大功能。让我们拭目以待！

项目地址#

GitHub 仓库：https://github.com/yikart/AiToEarn
详细文档：https://github.com/yikart/AiToEarn/blob/main/README_CN.md

互动时间#

你平时在内容创作和运营中遇到的最大挑战是什么？AiToEarn 能解决你的问题吗？欢迎在评论区分享你的想法！

如果你觉得这篇文章有用，别忘了点赞、在看并分享给身边的内容创作者们～

（注：文章部分信息来源于项目官方文档）

Dify应用实战(9) - 问题分类

2025-07-23T12:32:13.000Z

本文适用对象：初级水平

目标：利用问题分类将对话拆分为不同场景，将复杂使用场景转为多个单一场景

上一节Dify应用实战课，我们开启了一个新的项目，智能医疗分诊助手。

今天我们将基于智能医疗分诊助手，进行更为复杂的智能问答。

学习完成，你将掌握如何构建一个应用，能处理复杂场景的任务，通过场景拆解，达到化繁为简的目的。

01.动手做一做#

上次课的分诊应用，只有关键的一步，利用了大语言模型内在的自注意力机制，就能完成识别症状与导流的工作。

今天我们来要来增加这个智能医疗分诊助手”医小智”的能力。

因为在实际的场景中，有可能还是要确定大致问题的范围，然后再做出更加精准的判断。所以，就需要用到Dify的另一个组件”问题分类器”。

图片

1
在上一课的流程基础上，我们在"开始"之后添加一个"问题分类器"，分类器同样也是需要选择一个大语言模型的，但是组件会约束大语言模型去匹配给定的分支的结果。
2

3
然后在每个分支后都能添加一个行动，可以是直接回复，也可以调用"LLM"，进一步对前面对话所获取的"信息"，和当前节点给予的"要求"，再来一轮对话。

图片

为了演示效果，麦金叔只对其中一个分支，做第二轮的大语言模型对话，其他分支，或回答”暂未实现，请稍等”，或回答”您的问题，触及到我的知识盲区了。您换一个问题吧！”。

以下是分别给出问话，走到不同分支的演示。

图片

好了，今天的知识点也非常简单，跟上节课的比，就是将一次大语音模型的对话，拆分出先对问题做出分类，然后后面再接着处理。

02.补充说明#

我们知道，大语言模型在问题回答上，可能还存在着差异。但是对给定一段信息，做信息分类，或者做总结，其置信度已经非常高了。

因此将一个复杂场景的应用，进行分而自治，拆分为几个简单场景，这样能更大程度的提高结果的准确性。

Dify的问题分类器能够高效，灵活地适应不同业务场景的需求。如果还需要进一步优化，可以通过增加领域特异性训练数据或者微调预训练模型，来作为分类器的模型基座，以提升效果。

总结

今天又学习一种新的组件”问题分类器”。用好它可以将一个全局的对话，约束到一个小范围内继续讨论。

通过对”医小智”的更精细化调教实战，让它真正的变成一个能落地的AI应用。

大模型的得力干将MCP(3) - SSE服务

2025-07-23T12:32:13.000Z

今天我们将继续学习，将了解MCP服务的另一种通信方式。当然这两种都是有不同的适用场景的，并非竞争的关系。后面也会说明，其各自的优缺点和场景。

等系列课学习完成，你将能了解什么是MCP，如何开发MCP和如何实际使用它（当然我们会回归到Dify中，配合LLM，更加完善我们的AI应用适用场景）。

01.动手准备#

在我们动手写一个自己的SSE版本的MCP之前，又需要了解协议的一些概念，这样做起来就得心应手了。

Resoures：暴露结构化数据的内容给LLM。
Prompts：提供给LLM应用的可重用Prompt模板。
Tools：提供在服务端给LLM应用特别是Agent使用的工具。
Roots：定义API的接入点和访问路径
Sampling：允许服务器通过客户端请求LLM完成

当然以上不是全部都必须，比如可以只实现Tools功能，那我们同样从TypeScript的SDK开始。

上一课的例子是通过stdio传输数据，即数据是本地机器的进程间通信。适合AI助手工具来软件使用。

而今天我们来尝试实现远程通信。

02.动手做一做#

1
复制一下上节课的项目，做以下修改：

1
const app = express();
2

3
// to support multiple simultaneous connections we have a lookup object from
4
// sessionId to transport
5
// const transports: {[sessionId: string]: SSEServerTransport} = {};
6
let transport: SSEServerTransport;
7
app.get("/sse", async (_: Request, res: Response) => {
8
  console.log("Received connection");
9
  transport = new SSEServerTransport("/message", res);
10
  await server.connect(transport);
11
});
12

13
app.post("/messages", async (req: Request, res: Response) => {
14
  console.log("Received message");
15

16
  await transport.handlePostMessage(req, res);
17
});
18

19
const PORT = process.env.PORT || 3001;
20
app.listen(PORT, () => {
21
  console.log(`Server is running on port ${PORT}`);
22
});

展开收起

记得把express包依赖也加入到package.json。

1
npm run build
2
node index.js

图片

测试一下是否工作正常。使用API测试工具，访问http://localhost:3001/sse，如果成功，会出现如下图结果。

图片

同时，刚刚启动node的窗口，也会打印”Received connection”的日志。

这样，就完成了SSE的MCP服务改造。

03.补充说明#

看起来一切都是那么的简单。但是仅仅靠测试工具测试它工作，这才是第一步。而我们要让它服务大模型，所以还需要一个相对于的MCP client，让它们之间正常交互数据，才算完整。

不要着急，麦金叔接下来会继续介绍，请耐心等待。

总结

今天学习了MCP服务的SSE实现。理解stdio的方式与封装为远程服务之间的代码差异。但是，还有更多的MCP的模块没有引入，后面的文章将继续探讨，敬请期待。

Dify应用实战(10) - 循环处理

2025-07-23T12:32:13.000Z

本文适用对象：初级水平

目标：利用迭代的方法，对多个数据条目进行相同的处理

上一节Dify应用实战课，我们继续对新项目智能医疗分诊助手，进行了分解学习。

今天我们又将暂停一下，先学一下循环的处理。

学习完成，你将掌握如何对多条相同形式的数据，按照遍历处理的方法，进行加工处理。

01.动手做一做#

今天的任务会新开一个workflow，完成后可以合并至”每日智选”应用内。

再复习一下”每日智选”的内容，通过获取天气API，得到天气信息，输出到图片和语音中。而现在最主要的内容，是热点新闻和解读。接下来会获取每日热点新闻10条，然后填充进结果图。

添加节点”HTTP请求”，配置该节点为获取热点新闻。

图片

接着在其后，添加节点”LLM”，设置如下，上下文选择”HTTP请求”的请求结果。提示词填写：

1
根据获得的 上下文 内容，对其进行内容提取：
2

3
1\. 需要得到author\_name新闻来源，title新闻标题和url文章链接
4

5
2.严格按照json格式输出，参照key为类型，值为内容的形式，不需要解释。
6

7
3.新闻来源需要有影响力的媒体，不要采收自媒体类型的。
8

9
4.一次提取只需要10条。

图片

因大语言模型输出的结果为非结构化数据，需要使用”参数提取器”，进行转化。添加节点后，设置输入为”LLM”的output，输出修改为对象数组，如下图：

图片

现在我们一共得到10组包含新闻标题的数据。如何处理呢？这就是今天的重点，添加新节点”迭代”

图片

整个迭代(或者叫循环)，是以数据组来驱动的，所以这个节点的输入就是一个对象数组。

图片

“迭代”节点内部，所有的节点，都会在对象数组的元素上进行处理，因此”迭代”的开始，隐含的参数就是循环的下标index和元素item。

图片

获取到其中的元素之后，我们就使用”模版转换”，之前的教程已经介绍过，将标题内容和原始网址对应的内容，再次利用”LLM”处理，做摘要的提取。这里就省略了。

图片

经过循环对每条新闻的处理，我们就获得了”每日智选”主体内容的文案，剩下的工作就是，对图片布局的规划了。

希望今天的动手内容，也能跟着麦金叔做下来。

02.补充说明#

截止今天为止，“每日智选”AI小应用的大部分功能都已经实现。

大家也能举一反三，能将所学知识真正的应用到自己工作中。

当然，自己做一个新的类似的AI应用开发，还会遇到各种各样的问题。但万事开头难，只要动手开始做了，你就已经成功了一半。

我相信你们肯定听过这句话：打败你的不是AI，而是会用AI的人。麦金叔希望你能花点时间，跟着这些简单的例子练一练，也成为那个打败别人的会AI的人。

总结

今天学习一个重要的新的组件”迭代”。它实际上是编程中非常重要并常用的一个思想。

不管你要处理一大堆数据也好，还是读一堆书也好，都是要通过遍历的方法去”处理”它。

FlyCut Caption：AI 辅助视频剪辑神器，让剪视频不再痛苦！

2025-07-23T12:32:13.000Z

嗨，视频创作者们！#

你是否也有过这样的经历：

辛辛苦苦录完一段视频，结果后期剪辑时发现，口误、停顿、重复的内容占了一大半。为了剪出干净的视频，你得在时间轴上来回拖动，逐帧查找需要删除的片段，一下午的时间就这样耗在了剪辑上…

别担心，今天我要给你们推荐一个视频剪辑神器——FlyCut Caption，它能让你告别繁琐的剪辑过程，轻松剪出高质量视频！

什么是 FlyCut Caption？#

FlyCut Caption 是一个开源的 AI 辅助视频剪辑工具，它的核心思路非常简单但高效：

AI 自动转字幕：将视频中的语音转换为带时间戳的字幕
可视化剪辑：通过勾选字幕来选择要删除的片段
一键导出：自动拼接保留的片段，生成最终视频

就这么三步，「找废话、剪废话」的过程从体力活变成了扫一眼的事，效率直接提升 10 倍！

FlyCut Caption

核心功能详解#

1️⃣ AI 智能字幕生成#

上传视频后，FlyCut Caption 会自动使用 Whisper 模型识别视频中的语音，生成精确的字幕。它支持多种语言，时间戳精确到字级别，识别效果非常出色。

识别过程在浏览器后台运行，不影响界面操作，等待片刻后，完整的字幕列表就会呈现在你面前。

文件上传界面

2️⃣ 可视化剪辑操作#

生成字幕后，你可以在编辑界面中直接勾选需要删除的片段。操作非常直观：

点击字幕可跳转到对应视频位置，确认内容
支持批量选择、全选、反选等操作
预览模式可实时查看剪辑效果
支持撤销/重做，操作更放心

ASR 设置界面

3️⃣ 字幕样式与导出选项#

剪辑完成后，你可以为视频添加字幕，调整字体大小、颜色、位置等样式，实现所见即所得的效果。

导出时，你可以选择视频质量和格式，系统会自动拼接保留的片段。同时，字幕也可以导出为 SRT 或 JSON 格式，方便后续使用。

ASR 处理界面

4️⃣ 本地处理，数据安全#

最值得一提的是，FlyCut Caption 的所有处理过程都在浏览器本地完成，不需要将视频文件上传到任何服务器。

Whisper 模型通过 Transformers.js 在本地运行
视频处理使用 WebAV 技术
数据完全保存在本地，保护你的隐私

这对于处理商业素材或敏感内容的创作者来说，是一个非常重要的优势！

字幕编辑界面

快速开始使用#

本地部署#

环境要求：Node.js 18+ 和 pnpm

克隆项目

Terminal window

1
git clone https://github.com/x007xyz/flycut-caption.git
2
cd flycut-caption

安装依赖
Terminal window
```
1
pnpm install
```
启动服务
Terminal window
```
1
pnpm dev
```
访问应用 打开浏览器访问 http://localhost:5173

在线体验#

如果你不想本地部署，也可以直接访问作者提供的在线演示站点，立即体验 FlyCut Caption 的强大功能。

适用场景#

FlyCut Caption 特别适合以下场景：

教程视频：快速剪辑掉口误和重复内容
演讲录制：保留核心内容，去除冗余部分
vlog 创作：精简视频长度，提高观看体验
线上课程：优化教学内容，提升课程质量

总结#

在视频创作中，「整理内容」往往是最耗时的环节。FlyCut Caption 通过 AI 技术，将这个过程变得简单高效，让你能够将更多精力放在内容创作本身。

无论是专业创作者还是视频爱好者，都能从这个工具中获益。它不仅节省时间，还能提高视频质量，让你的作品更加专业。

项目地址#

GitHub 项目：https://github.com/x007xyz/flycut-caption
在线演示：[访问演示站点]

互动时间#

你平时剪辑视频时遇到的最大痛点是什么？FlyCut Caption 能解决你的问题吗？欢迎在评论区分享你的想法！

如果你觉得这篇文章有用，别忘了点赞、在看并分享给身边的视频创作者们～

推荐阅读：

（注：文章部分图片来源于项目仓库，如有侵权请联系删除）

Dify应用实战(3) - 代码处理

2025-07-23T12:32:13.000Z

前言#

让大家知道如何通过工具插件来获取互联网的实时数据，结合大语言模型，才能让结果更加有用。
目前应该已经掌握了知识库的使用，工具插件的使用，并要熟练掌握”LLM”的多次使用。更高阶的知识，是LLM内模型能力的掌握（比如哪家的模型，擅长于什么任务？使用多大的模型，既能满足工作需求，又节约使用费用？），但这可以放在后面再学习。
复习了上节课的内容后，我们继续AI学习之旅。今天教大家使用代码节点，进一步对流程中产生的中间数据，进行”加工”处理，来满足要求。
比如，我们用了高德的”天气预报”工具，得到了今天和将来3天的天气预报数据。但我们只需要拿今天的天气情况，把它整合进我们自己的应用”每日智选”的页面内。

01.动手做一做#

基于上一节课的流程，在”天气预报”节点之后，新增一个”代码执行”的节点。

图片

添加之后，连接”天气预报”节点和新增节点；再连接新增节点和结束节点。新增参数(一定要先连接)，“代码执行”的输入，选择”天气预报”的text。然后把结束节点的输出也改为”代码执行”的text。

点击”发布”，保存。提示”操作成功”。就可以进行测试了。测试如下：

图片

02. 代码执行的开发与调试#

1
今天的任务，需要有一定的代码能力，但不是非常复杂，都只是简单的数据转换提取操作而已。难度提示为"中级"。
2

3
代码节点支持Python和JavaScript，这次课程以Python为例。

图片

简单讲解一下：定义一个main函数，接受输入字符串，然后输出一个字典。
注意main的参数名一定要与输入变量定义的名字一致，否则会报错，而输出因为定义了字典，所以必须按照return {“result”: 字符串}的格式给出，一定要严格按照这个规则执行。
因为输入的是字符串，所以根据数据内容，假如是JSON字符串格式，就需要对其进行JSON对象的转换。本例中4天的天气数据，是按数组的形式传输的。那么就可以遍历数组，找出其中关键字date与今天日期匹配的那个对象，再将其输出为字符串即可。如果是其他的格式，也可以通过正则表达式进行关键内容的提取。
类似开发就根据业务需求进行处理即可。这里麦金叔要特别提一下调试的问题。在Dify的沙箱环境里面执行Python脚本，其错误提示还是比较粗糙的，对开发定位要求比较高，往往有点”丈二和尚摸不着头脑”。所以麦金叔建议，还是先在本地的电脑调试完成（可以单步Debug，不比看那乱七八糟的报错要便捷的多），再复制进Dify的代码节点，否则比较浪费时间。
当然，今天的课程虽然对普通人来说略微有点难度，但总体来说，对于有代码经验的人来说，也不算特别难。只要多学习别人的流程里面的代码，再结合自己动手实践，相信很快就能掌握。

总结#

今天在上次的工作流基础上，进一步增加利用Python来处理数据的过程，让我们得到的数据越来越接近真实可用的状态。同时，代码节点可以充当很多功能节点的粘合剂，进行各种数据或者流程的转换，这在实际应用中也是必不可少的功能。希望大家再接再厉，跟着麦金叔踏实的走好每一步。

详细！离线部署大模型：ollama+deepseek+open-webui安装使用方法及常见问题解决

2025-07-23T12:32:13.000Z

ollama 是一个开源的本地大语言模型运行框架，它提供了非常简单便捷的使用形式，让用户可以十分方便的在本地机器上部署和运行大型语言模型，从而实现免费离线的方式使用 LLM 能力，并确保私有数据的隐私和安全性。

1 ollama 安装#

ollama 支持多种操作系统，包括 macOS、Windows、Linux 以及通过 Docker 容器运行。其安装、使用及模型下载非常简单，可以简单概括为以下几步：

• 下载 ollama 安装程序并安装。
• 启动 ollama，执行命令下载和运行模型。如：ollama run deepseek-r1:1.5b
• 以命令行交互、API 调用、第三方应用接入等形式使用其服务。

1.1 硬件要求#

ollama 本身对硬件要求并不高，主要取决于运行模型的要求。基本建议：

你应该至少有 4 GB 的 RAM 来运行 1.5B 模型，至少有 8 GB 的 RAM 来运行 7B 模型，16 GB 的 RAM 来运行 13B 模型，以及 32 GB 的 RAM 来运行 33B 模型。

假若需要本地私有化部署具有实用性的模型，应至少有独立显卡并有 4G 以上显存。纯 CPU 模式虽然也可以运行，但生成速度很慢，仅适用于本地开发调试体验一下。

本人实测在Mac Studio 2023 版(Apple M2 Max 芯片：12核、32G内存、30核显、1TB SSD)上，运行 deepseek:1.5b 模型响应非常快，可以较为流畅的运行 deepseek-r1:32b 及以下的模型。

DeepSeek-r1 相关版本及大小参考：

参数版本	模型大小	建议CPU	建议内存	建议显存	特点
deepseek-r1<1>.5b	1.1GB	4核	4~8G	4GB	轻量级，速度快、普通文本处理
deepseek-r1<7b>	4.7G	8核	16G	14GB	性能较好，硬件要求适中
deepseek-r1<8b>	4.9GB	8核	16G	14GB	略强于 7b，精度更高
deepseek-r1<14b>	9GB	12核	32G	26GB	高性能，擅长复杂任务，如数学推理、代码生成
deepseek-r1<32b>	20GB	16核	64G	48GB	专业级，适合高精度任务
deepseek-r1<70b>	43GB	32核	128G	140GB	顶级模型，适合大规模计算和高复杂度任务
deepseek-r1<671b>	404GB	64核	512G	1342GB	超大规模，性能卓越，推理速度快

1.2 Windows \ macOS \ Linux 下安装 ollama#

Windows 和 macOS 用户可访问如下地址下载安装文件并安装：

• 国内中文站下载：http://ollama.org.cn/download/
• 官方下载：https://ollama.com/download/
• github release 下载：https://github.com/ollama/ollama/releases/

Linux 用户可以执行如下命令一键安装：

Terminal window

1
curl -fsSL https://ollama.com/install.sh | bash

安装完成后，可以通过执行 ollama --version 命令查看 ollama 版本信息，以验证是否安装成功。

ollama 离线安装：

Windows 和 macOS 下直接复制安装文件到本地本进行安装即可。

Linux 下的离线安装主要步骤参考如下：

Terminal window展开收起

1
mkdir -p /home/ollama
2
cd /home/ollama
3

4
# 查看服务器 CPU 信息获取其架构，如：x86_64
5
lscpu
6

7
# 访问如下地址，下载对应架构的 ollama 安装包
8
# https://github.com/ollama/ollama/releases/
9
# - x86_64 CPU 选择下载 ollama-linux-amd64
10
# - aarch64|arm64 CPU 选择下载 ollama-linux-arm64
11
# 示例：
12
wget https://github.com/ollama/ollama/releases/download/v0.5.11/ollama-linux-amd64.tgz
13

14
# 下载 安装脚本，并放到 /home/ollama 目录下
15
wget https://ollama.com/install.sh
16

17
# 将 ollama-linux-amd64.tgz 和 install.sh 拷贝到需要安装的机器上，如放到 /home/ollama 目录下
18
# 然后执行如下命令：
19
tar -zxvf ollama-linux-amd64.tgz
20
chmod +x install.sh
21
# 编辑 install.sh 文件，找到如下内容
22
curl --fail --show-error --location --progress-bar -o $TEMP_DIR/ollama "https://ollama.com/download/ollama-linux-${ARCH}${VER_PARAM}"
23
# 注释它，并在其下增加如下内容：
24
cp ./ollama-linux-amd64 $TEMP_DIR/ollama
25

26
# 执行安装脚本
27
./install.sh
28

29
# 模型的离线下载请参考下文模型导入部分

展开收起

1.3 基于 Docker 安装 ollama#

基于 Docker 可以使得 ollama 的安装、更新与启停管理更为便捷。

首先确保已安装了 docker，然后执行如下命令：

1
# 拉取镜像
2
docker pull ollama/ollama
3

4
# 运行容器：CPU 模式
5
docker run -d -p 11434:11434 -v /data/ollama:/root/.ollama --name ollama ollama/ollama
6
# 运行容器：GPU 模式
7
docker run --gpus=all -d -p 11434:11434 -v /data/ollama:/root/.ollama --name ollama ollama/ollama
8

9
# 进入容器 bash 下并下载模型
10
docker exec -it ollama /bin/bash
11
# 下载一个模型
12
ollama pull deepseek-r1:8b

也可以基于 docker-compose 进行启停管理。docker-compose.yml 参考：

1
services:
2
  ollama:
3
    image:ollama/ollama
4
    container_name:ollama
5
    restart:unless-stopped
6
    ports:
7
      -11434:11434
8
    volumes:
9
      -/data/ollama:/root/.ollama
10
    environment:
11
        # 允许局域网跨域形式访问API
12
        OLLAMA_HOST=0.0.0.0:11434
13
        OLLAMA_ORIGINS=*

1.4 修改 ollama 模型默认保存位置#

ollama 下载的模型默认的存储目录如下：

• macOS: ~/.ollama/models
• Linux: /usr/share/ollama/.ollama/models
• Windows: C:\Users\\.ollama\models

若默认位置存在磁盘空间告急的问题，可以通过设置环境变量 OLLAMA_MODELS 修改模型存储位置。示例：

1
# macOS / Linux：写入环境变量配置到 ~/.bashrc 文件中
2
echo 'export OLLAMA_MODELS=/data/ollama/models' >> ~/.bashrc
3
source ~/.bashrc
4

5
# Windows：按 `WIN+R` 组合键并输入 cmd 打开命令提示符
6
# 然后执行如下命令写入到系统环境变量中
7
setx OLLAMA_MODELS D:\data\ollama\models

如果已经下载过模型，可以从上述默认位置将 models 目录移动到新的位置。

对于 docker 安装模式，则可以通过挂载卷的方式修改模型存储位置。

1.5 使用：基于 API 形式访问 ollama 服务#

ollama 安装完成并正常启动后，可以通过命令行形式运行模型（如：ollama run deepseek-r1:1.5b），并通过命令行交互的方式进行测试。

此外也可以通过访问 http://localhost:11434 以 API 调用的形式调用。示例：

1
curl http://localhost:11434/api/generate -d '{
2
  "model": "deepseek-r1:8b",
3
  "stream": false,
4
  "prompt": "你是谁"
5
}

ollama API 文档参考：

2 使用 ollama 下载和运行模型#

2.1 使用 ollama 命令行下载和运行模型#

执行如下命令下载并运行一个模型：

1
# 基本格式为：
2
ollama run 
3

4
# 例如下载并运行 deepseek-r1 的 1.5b 模型
5
# 如果下载模型速度开始较快后面变慢，可以 kill 当前进程并重新执行
6
ollama run deepseek-r1:1.5b

运行成功则会进入命令行交互模式，可以直接输入问题并获得应答反馈，也可以通过 API 调用方式测试和使用。

从如下地址可搜索 ollama 所有支持的模型：

• 中文站：https://ollama.org.cn/search
• 官方站：https://ollama.com/search

从 HF 和魔塔社区下载模型

ollama 还支持从 HF 和魔塔社区下载第三方开源模型。基本格式为：

1
# 从 HF(https://huggingface.co) 下载模型的格式
2
ollama run hf.co/{username}/{reponame}:latest
3
# 示例：
4
ollama run hf.co/bartowski/Llama-3.2-1B-Instruct-GGUF:Q8_0
5

6
# 从魔塔社区(https://modelscope.cn)下载模型的格式
7
ollama run modelscope.cn/{username}/{model}
8
# 示例：
9
ollama run modelscope.cn/Qwen/Qwen2.5-3B-Instruct-GGUF:Q3_K_M

2.2 使用 ollama create 导入本地模型#

通过 ollama run 和 ollama pull 命令均是从官方地址下载模型，可能会遇到下载速度慢、下载失败等问题。

ollama 支持从本地导入模型。我们可以从第三方下载模型文件并使用 ollama create 命令导入到 ollama 中。

例如，假若我们下载了 deepseek-r1:8b 模型文件，并保存在 /data/ollama/gguf/deepseek-r1-8b.gguf，则可执行如下命令进行导入：

1
cd /data/ollama/gguf
2
echo "From ./deepeek-r1-8b.gguf" > modelfile-deepseek-r1-8b
3
ollama create deepseek-r1:8b -f modelfile-deepseek-r1-8b
4

5
# 查看模型信息
6
ollama list
7
ollama show deepseek-r1:8b
8

9
# 运行模型(以命令行交互模式使用)
10
ollama run deepseek-r1:8b

3 ollama 常用命令参考#

ollama 提供了丰富的命令行工具，方便用户对模型进行管理。

• ollama --help：查看帮助信息。
• ollama serve：启动 ollama 服务。
• ollama create [-f Modelfile]：根据一个 Modelfile 文件导入模型。
• ollama show ：显示某个模型的详细信息。
• ollama run ：运行一个模型。若模型不存在会先拉取它。
• ollama stop ：停止一个正在运行的模型。
• ollama pull ：拉取指定的模型。
• ollama push ：将一个模型推送到远程模型仓库。
• ollama list：列出所有模型。
• ollama ps：列出所有正在运行的模型。
• ollama cp ：复制一个模型。
• ollama rm ：删除一个模型。

4 ollama 安装使用常见问题及解决#

4.1 ollama 模型下载慢：离线下载与安装模型#

通过 ollama 官方命令拉取模型，可能会遇到网速慢、下载时间过长等问题。

4.1.1 开始快后来慢：间隔性重启下载#

由于模型文件较大，下载过程中可能会遇到开始网速还可以，后面变慢的情况。许多网友反馈退出然后重试则速度就可以上来了，所以可以尝试通过每隔一段时间退出并重新执行的方式以保持较快的下载速率。

以下是基于该逻辑实现的下载脚本，注意将其中的 deepseek-r1:7b 替换为你希望下载的模型版本。

Windows 下在 powershell 中执行：

1
while ($true) {
2
    $modelExists = ollama list | Select-String "deepseek-r1:7b"
3

4
    if ($modelExists) {
5
        Write-Host "模型已下载完成！"
6
        break
7
    }
8

9
    Write-Host "开始下载模型..."
10
    $process = Start-Process -FilePath "ollama" -ArgumentList "run", "deepseek-r1:7b" -PassThru -NoNewWindow
11

12
    # 等待60秒
13
    Start-Sleep -Seconds 60
14

15
    try {
16
        Stop-Process -Id $process.Id -Force -ErrorAction Stop
17
        Write-Host "已中断本次下载，准备重新尝试..."
18
    }
19
    catch {
20
        Write-Host "error"
21
    }
22
}

展开收起

macOS / Linux 下在终端中执行：

1
#!/bin/bash
2

3
whiletrue; do
4
    # 检查模型是否已下载完成
5
    modelExists=$(ollama list | grep "deepseek-r1:7b")
6

7
    if [ -n "$modelExists" ]; then
8
        echo"模型已下载完成！"
9
        break
10
    fi
11

12
    # 启动ollama进程并记录
13
    echo"开始下载模型..."
14
    ollama run deepseek-r1:7b &  # 在后台启动进程
15
    processId=$!  # 获取最近启动的后台进程的PID
16

17
    # 等待60秒
18
    sleep 60
19

20
    # 尝试终止进程
21
    ifkill -0 $processId 2>/dev/null; then
22
        kill -9 $processId# 强制终止进程
23
        echo"已中断本次下载，准备重新尝试..."
24
    else
25
        echo"进程已结束，无需中断"
26
    fi
27
done

展开收起

4.1.2 通过网盘等第三方离线下载并导入 ollama 模型#

可以通过国内的第三方离线下载模型文件，再导入到 ollama 中。详细参考 2.2 章节。

deepseek-r1 相关模型夸克网盘下载：

链接：https://pan.quark.cn/s/7fa235cc64ef 提取码：wasX

也可以从魔塔社区、HuggingFace 等大模型社区搜索并下载 stuff 格式的模型文件。例如：

4.1.3 从国内大模型提供站下载模型#

ollama 支持从魔塔社区直接下载模型。其基本格式为：

1
`ollama run modelscope.cn/{model-id}`

一个模型仓库可能包含多个模型，可以指定到具体的模型文件名以只下载它。示例：

1
ollama run modelscope.cn/Qwen/Qwen2.5-3B-Instruct-GGUF
2
#
3
ollama run modelscope.cn/Qwen/Qwen2.5-3B-Instruct-GGUF:qwen2.5-3b-instruct-q3_k_m.gguf

下载 deepseek-r1 模型命令参考：

1
# deepseek-r1:7b
2
ollama run modelscope.cn/unsloth/DeepSeek-R1-Distill-Qwen-7B-GGUF:DeepSeek-R1-Distill-Qwen-7B-Q4_K_M.gguf
3
# deepseek-r1:14b
4
ollama run modelscope.cn/unsloth/DeepSeek-R1-Distill-Qwen-14B-GGUF:Q4_K_M
5
# deepseek-r1:32b
6
ollama run modelscope.cn/unsloth/DeepSeek-R1-Distill-Qwen-32B-GGUF:Q4_K_M

此外，也可以从 HF 的国内镜像站（https://hf-mirror.com）查找和拉取模型，方法与上述类似：

1
# 基本格式
2
ollama run hf-mirror.com/{username}/{reponame}:{label}
3

4
# 示例 - 拉取 deepseek-r1:7b
5
ollama run hf-mirror.com/unsloth/DeepSeek-R1-Distill-Qwen-7B-GGUF:Q4_K_M

4.2 ollama 服务设置允许局域网访问#

默认情况下 API 服务仅允许本机访问，若需要允许局域网其他设备直接访问，可修改环境变量 OLLAMA_HOST 为 0.0.0.0，并修改 OLLAMA_ORIGINS 为允许的域名或 IP 地址。

环境变量设置示例：

1
# windows 命令提示符下执行：
2
setx OLLAMA_HOST 0.0.0.0:11434
3
setx OLLAMA_ORIGINS *
4

5
# macOS 终端下执行：
6
launchctl setenv OLLAMA_HOST "0.0.0.0:11434"
7
launchctl setenv OLLAMA_ORIGINS "*"

特别注意：

• 如果你是在云服务器等拥有公网IP的环境上部署，请谨慎做此设置，否则可能导致 API 服务被恶意调用。
• 若需要局域网其他设备访问，请确保防火墙等安全设置允许 11434 端口访问。
• 若需要自定义访问端口号，可通过环境变量 OLLAMA_HOST 设置，如：OLLAMA_HOST=0.0.0.0:11435。

4.3 为 ollama API 服务访问增加 API KEY 保护#

为云服务器部署的服务增加 API KEY 以保护服务 如果你是通过云服务器部署，那么需要特别注意服务安全，避免被互联网工具扫描而泄露，导致资源被第三方利用。

可以通过部署 nginx 并设置代理转发，以增加 API KEY 以保护服务，同时需要屏蔽对 11434 端口的互联网直接访问形式。

nginx 配置：

1
server {
2
    # 用于公网访问的端口
3
    listen 8434;
4
    # 域名绑定，若无域名可移除
5
    server_name your_domain.com;
6

7
    location / {
8
        # 验证 API KEY。这里的 your_api_key 应随便修改为你希望设置的内容
9
        # 可通过 uuid 生成器工具随机生成一个：https://tool.lzw.me/uuid-generator
10
        if ($http_authorization != "Bearer your_api_key") {
11
            return 403;
12
        }
13

14
        # 代理转发到 ollama 的 11434 端口
15
        proxy_pass http://localhost:11434;
16
        proxy_set_header Host $host;
17
        proxy_set_header X-Real-IP $remote_addr;
18
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
19
        proxy_set_header X-Forwarded-Proto $scheme;
20
    }
21
}

展开收起

5 集成可视化工具#

在部署了 ollama 并拉取了 deepseek 等模型后，即可通过命令行交互和 API 服务方式使用，但使用起来并不方便。

开源社区中有许多大模型相关的可视化工具，如 open-webui、chat-ui、cherry-studio、AnythingLLM 等，可以方便地集成 ollama API 服务，提供图形化界面使用，以实现聊天机器人、问答知识库等多元化应用。在官方文档中列举了大量较为流行的工具应用：https://ollama.readthedocs.io/quickstart/#web

我们后续会选择其中较为典型的工具进行集成和介绍。

5.1 示例：基于 docker 部署 open-webui 并配置集成 ollama 服务#

Open WebUI 是一个开源的大语言模型项目，通过部署它可以得到一个纯本地运行的基于浏览器访问的 Web 服务。它提供了可扩展、功能丰富、用户友好的自托管 AI Web 界面，支持各种大型语言模型（LLM）运行器，可以通过配置形式便捷的集成 ollama、OpenAI 等提供的 API。

通过 Open WebUI 可以实现聊天机器人、本地知识库、图像生成等丰富的大模型应用功能。

在开始之前，请确保你的系统已经安装了 docker。

接着拉取大语言模型 deepseek-r1:8b 和用于 RAG 构建本地知识库的嵌入模型 bge-m3：

1
`ollama pull deepseek-r1:8b ollama pull bge-m3`

然后新建文件 docker-compose.yml，内容参考：

1
services:
2
  open-webui:
3
    image:ghcr.io/open-webui/open-webui:main
4
    environment:
5
      -OLLAMA_API_BASE_URL=http://ollama:11434/api
6
      -HF_ENDPOINT=https://hf-mirror.com
7
      -WEBUI_NAME="LZW的LLM服务"
8
      # 禁用 OPENAI API 的请求。若你的网络环境无法访问 openai，请务必设置该项为 false
9
      # 否则在登录成功时，会因为同时请求了 openai 接口而导致白屏时间过长
10
      -ENABLE_OPENAI_API=false
11
      # 设置允许跨域请求服务的域名。* 表示允许所有域名
12
      -CORS_ALLOW_ORIGIN=*
13
      # 开启图片生成
14
      -ENABLE_IMAGE_GENERATION=true
15
      # 默认模型
16
      -DEFAULT_MODELS=deepseek-r1:8b
17
      # RAG 构建本地知识库使用的默认嵌入域名
18
      -RAG_EMBEDDING_MODEL=bge-m3
19
    ports:
20
      -8080:8080
21
    volumes:
22
      -./open_webui_data:/app/backend/data
23
    extra_hosts:
24
      # - host.docker.internal:host-gateway

展开收起

这里需注意 environment 环境变量部分的自定义设置。许多设置也可以通过登录后在 web 界面进行修改。

在该目录下执行该命令以启动服务：docker-compose up -d。成功后即可通过浏览器访问：http://localhost:8080。

服务镜像更新参考：

1
# 拉取新镜像
2
docker-compose pull
3
# 重启服务
4
docker-compose up -d --remove-orphans
5
# 清理镜像
6
docker image prune

• open-webui 详细文档参考：https://docs.openwebui.com/getting-started/env-configuration

可选：开启“联网搜索”功能

操作路径：设置 - 联网搜索 - 启用联网搜索

当前已支持接入的联网搜索引擎中，在不需要魔法上网的情况下，有 bing 和 bocha 可以选择接入。基本只需要前往注册并获取 API KEY 回填到这里即可。如果需要保护隐私数据，请不要开启并配置该功能。

• 博查文档：https://aq6ky2b8nql.feishu.cn/wiki/XgeXwsn7oiDEC0kH6O3cUKtknSR

总结与参考#

通过以上内容，我们了解了 ollama 在国内环境下的安装使用方法，并介绍了因为国内网络特色导致安装过程可能会遇到的常见问题及解决办法。希望这些内容对你有所帮助，如果你有任何问题或建议，欢迎在评论区留言交流。

• ollama 官方站：https://ollama.com
• ollama 中文站：https://ollama.org.cn
• ollama 入门：https://ollama.readthedocs.io/quickstart/
• ollama 常见问题：https://ollama.readthedocs.io/faq/
• 魔塔社区：https://modelscope.cn
• HF Mirror：https://hf-mirror.com
• open-webui 文档：https://docs.openwebui.com

转载#

本文转载自志文工作室

Dify应用实战(4) - 生成语音

2025-07-23T12:32:13.000Z

我们继续AI学习之旅，今天教大家使用TTS节点，来生成语音播报的音频数据。
学习完成，你将掌握生成语音文件的方法，可以将自己的文字直接变为播客内容。

01.动手做一做#

基于上一节课的流程，在”代码执行”节点之后，新增一个”Text To Speech”的节点。

图片

添加之后，连接”代码执行”节点和新增节点；再连接新增节点和结束节点。新增参数(一定要先连接)，“Text To Speech”的输入，选择”代码执行”的text。
TTS节点需要有模型，这里选择SiliconCloud的fish-speech-1.5。
硅基流动配置非常简单，直接点配置弹出对话框后，跟着”从SiliconFlow获取API Key”的向导，打开官网，注册后创建API Key，然后复制到Dify的配置框，即可。

图片

新增模型之后，在”系统模型设置”的文本转语音模型，选中fishaudio。

图片

同时新增节点，记得选择声音的类型，包括了4男4女的备选声音，可以都测试一下，看看是否满足自己的需要。
“结束”节点的输出改为”Text To Speech”的files（这里注意不要再选成text了）。
点击”发布”，保存。提示”操作成功”。就可以进行测试了。测试如下：

图片

结果输出是一个wav文件的下载链接，点击下载后，使用本地音频播放软件打开就可以检查内容。

02.补充说明#

今天的任务，非常简单，经过前几天的学习，应该操作起来很是得心应手了。
但注意一下，硅基流动的这个TTS模型是收费的，需要先充值才能使用，麦金叔充了10块钱。还有很多模型可以免费，或者限免使用。不过使用费用还算可以接受吧，测试了几次，花掉3分钱。同时新用户进来就赠送13.99，够用一段时间了。
当然，如果不想这么简单的实现，希望挑战一下自己的，麦金叔这里也有复杂的方案，点赞留言，确有需要，可以单独出一期。
另外，今天的”代码执行”节点，也做了一下脚本更新。直接将JSON，格式化输出为播报文案。

1
def main(arg1: str) -> dict:
2
    import json
3
    import datetime
4
    today_date = datetime.date.today().strftime("%Y-%m-%d")
5
    report = json.loads(arg1)
6
    for index in range(0, len(report)):
7
        weather = report[index]
8
        if today_date == weather.get("date", ""):
9
            day_weather = weather.get("dayweather", "")
10
            day_temp = weather.get("daytemp_float", "")
11
            night_weather = weather.get("nightweather", "")
12
            night_temp = weather.get("nighttemp_float", "")
13
            day_temp_f = float(day_temp)
14
            day_temp_i = round(day_temp_f)
15
            night_temp_f = float(night_temp)
16
            night_temp_i = round(night_temp_f)
17
            res = "今日天气，白天%s，温度%d摄氏度，晚上%s，气温%d摄氏度" % (day_weather, day_temp_i, night_weather, night_temp_i)
18
            #today_weather = json.dumps(weather, ensure_ascii=False)
19
            return { "result": res, }

展开收起

总结

今天在上次的工作流基础上，进一步增加利用TTS来对获取内容进行语音生成处理，如果各位朋友有做播客的，那这一期就非常对你的胃口，操作也很简单。

Dify应用实战(12) - 数据库查询

2025-07-23T12:32:13.000Z

上一节Dify应用实战课，我们继续对新项目，智能医疗分诊助手，进行了分支条件的拆解。

今天我们学习数据库的查询操作。

学习完成，你将掌握如何对数据库中的数据进行获取。

01.动手做一做#

今天的任务基于智能分诊应用”医小助”。在”条件分支”的”case1”后新增一个”SQL查询”节点。

但是，需要先准备一下插件的安装(v1.0.0之后，已经升级需要安装插件)。

图片

插件安装之后，按下图所示进行添加，先点击”工具”，再找到刚才安装的”Database”，展开后选中”SQL Execute”。

图片

第一次使用会让先授权，按下图步骤进行设置。直接点”去授权”，不用管下面的API端点。这个以后有需要再说。

图片

授权之后，如果再用”数据库”工具，就不会再要求进行授权了。授权需要输入的内容如下：

1
mysql+pymysql://root:123456@192.168.0.101:3306/hospital

如果用的postgresql或者sqlite，就查询一下插件的说明文档即可。

图片

现在我们就可以填入查询SQL语句了

1
SELECT name, title, description FROM doctor WHERE department = '眼科' and status = 1;

输出暂时按”Markdown”内容输出。

图片

将后一个回复节点的输出，添加SQL查询的结果，如下图。

图片

保存之后，我们进行测试，如下：

图片

可以看到，如果走到”眼科分支，且与近视有关”，那么会获得数据库内查询出来的内容。

希望今天的动手实践，也能跟着麦金叔做下来。

02.补充说明#

今天学的数据库查询，对于普通人来说有点难度。

但AI应用的开发，一定是围绕大模型之后，再精细补充细节。

数据库的操作是AI前时代，数字化或者信息化过程中的重要一环。任何与软件，互联网等相关的开发，必然是不可能缺失数据库的。

与其将话语权交给别人，还不如也顺手把SQL查询学一学。这样我们的AI应用必将有血有肉，落地不再是空中楼阁。

总结#

今天学习一个新的组件”数据库查询”。有了它在AI应用开发的”拖线条”过程中，真正做到不再”说大话”，不会”胡编乱造”。但是，要使用它，门槛稍微高了那么一点点。除了需要有基础的数据库运维，最重要的还需要你能稍微了解一下SQL，有对数据操作的能力。

Dify应用实战(17) - 使用MCP服务

2025-07-23T12:32:13.000Z

今天我们将要继续企业应用之旅，让Dify变成一个超级中间站，能将开源的大几千MCP服务为我所用。

学习完成，你将会让自己的Dify也拥有更专业的使用MCP的能力。

01.准备环节#

我们之前详细学习了MCP所有关键的内容，是时候来表演了。

不过Dify是一个服务端运行的系统，它不像本地可以为MCP服务去准备运行环境。如果让Dify集成stdio方式的MCP，那改动就有点大了。

但是现存海量的MCP服务，绝大多数都是stdio方式，所以关键一点就是打通这个使用方式上的差异。

因此使用一个叫mcp-proxy的工具，就来的如此的顺理成章。(如果听不懂stdio的话，请复习前面的博文)

大模型的得力干将MCP(5) - 应用场景和发展方向，窥探先机，不容错过

为了不影响本地电脑的环境配置等，我们同样以容器的方式，去运行这个mcp-proxy。

根据它的说明文档，有两个地方需要修改为自己的。

重新打包一下镜像，加入uv运行环境。新建一个mcp-proxy.Dockerfile文件，内容如下：

图片

2.以上述镜像，加入需要代理的MCP服务，我们以mysql_mcp_server为例。新建一个docker-compose.yml文件，内容如下：

图片

现在启动docker compose up -d，去容器中看到输出log如下，就说明成功了。

图片

上述步骤完成，给我们干活的MCP服务就搭好了，接着开始操作Dify。

有两个插件需要准备好。

图片

如果你在插件市场看到他们的版本低于0.0.8，请去插件介绍的github上手动下载，然后通过本地插件的方式去安装。

如果你还没有这么快要去尝试，也不用主动升级，说不定你要用的时候已经有插件市场的0.0.8版本了。（一定要听劝，不要乱尝试）

至此，所有今天需要的准备就完成了，恭喜！

02.动手做一做#

今天为了演示，新建一个chatflow，把所有其他的干扰因素都排除。

在开始节点之后新增一个节点”Agent”。

第一步需要指定AGENT策略，点下拉箭头会出现”支持MCP工具的Agent”，点击之后会再展开，选择”FunctionCalling(Support MCP tools)”

图片

此时才开始正式配置相关参数。

第二步，模型这里选择支持FunctionCall的大模型，如qwen2.5。

第三步，工具列表这里点加号，把”通过SSE发现和调用MCP”里面包含的两个工具都加上

图片

如果是第一次配置这个工具，它会问你要授权，填入刚才docker提供MCP Proxy的服务地址和端口

1
{"mysql_mcp": {"url": "http://192.168.0.231:8066/sse","headers": {}, "timeout": 50, "sse_read_timeout": 300}}

保存时没有报错，说明就成功了。

第四步，MCP 服务配置的框内填入提供MCPProxy的地址，如下

1
{
2
  "mysql_mcp": {
3
    "url": "http://192.168.0.231:8066/sse",
4
    "headers": {},
5
    "timeout": 50,
6
    "sse_read_timeout": 300
7
  }
8
}

图片

最后把剩余的，指令，查询和最大迭代次数修改完就OK了，见上图。

见证奇迹的时刻到来了。我们进行测试，结果如下：

图片

除了运行时间长点，没毛病。本地测试环境，大模型运行效率不高。嘿嘿！

总结

今天学习了将MCP服务引入Dify系统，从而打通了大模型与更强大扩展工具之间的联系。你的Dify应用将会有更多更好的能力做出更酷的事情来。

Dify应用实战(13) - 工具调用

2025-07-23T12:32:13.000Z

今天我们学习大语言模型的Function Calling的使用。

学习完成，你将初步获得调用工具的能力。本节内容，非常考察动手能力，建议需要反复调试，并理解大语言模型的基础能力知识。

01.动手做一做#

今天的任务需要重开一个对话应用。当条件成熟之后，才能将今日所学集成进之前的AI应用开发中。

图片

将默认生成的3个节点中的第2个删除。并添加”Agent”节点。

图片

接着对该节点做配置，按下图步骤进行设置。

图片

选择完Function Callinging之后，就会出现真实的配置。

图片

首先需要手动选择一个配置的大语言模型。这里需要注意，不是所有的大模型都内在支持Function Calling，所以这就要求我们对大模型基础有一定的了解。比方说这一段时间非常热门的DeepSeek模型，就并没有支持Function Calling。

然后添加大模型调用的工具。这里添加了时间获取和查询天气这两个工具。

图片

“指令”输入框中添加如下内容：

如果用户问到天气问题，你可以使用工具来帮你完成任务。

1. 根据城市和日期查询天气，使用时必须提供城市和日期两个参数，提供参数的方式要满足如下结构：

1
{
2

3
   "name":"get_weather",
4
   "arguments": {
5
     "city": 查询的城市
6
     "date": 查询的日期
7
   }
8
}

2. 根据用户的描述，比如，“今天”，“明天”，“昨天”，“下周一”，获取实际日期，使用时，必须提供用户对于日期的描述这个参数，提供参数的方式要满足如下结构：

1
{
2

3
   "name": "time",
4

5
    "arguments": {
6

7
     "query": 用户对日期的描述
8

9
   }
10

11
}

而”查询”输入框，可以直接用”输入节点”的用户输入。如下图所示：

图片

最后将”Agent节点”，与”回复节点”连接，输出修改为Agent的TEXT。保存之后，我们进行测试，如下：

图片

如果你动手做完了，测试的时候并没有得到跟麦金叔的结果一样的内容，那说明你的操作并没有问题，只是细节需要进一步打磨。

这也是今天的内容设置为”高级”的原因。接着，试着自己去调用不同的大模型，修改提示词。然后查看运行日志，以得到当中的各个步骤符合预期。

02.补充说明#

今天学的Agent，对于普通人来说非常有难度。

需要自行补充有关大模型的基础能力的知识。

什么是Function Calling#

大语言模型的Function Calling能力允许模型调用外部函数或服务，以扩展其自身的能力，执行它本身无法完成的任务。以下是一些Function Calling的使用场景：

使用场景	说明
增强能力	大模型通过Function Calling可以调用外部工具或服务，例如实时数据检索、文件处理、数据库查询等，从而扩展其能力。
实时数据访问	由于大模型通常基于静态数据集训练，不具备实时信息。Function Calling允许模型访问最新的数据，提供更准确、更及时的回答。
提高准确性	在需要精确计算或特定领域知识时，大模型可以通过调用专门的函数来提高回答的准确性，例如调用数学计算函数、翻译服务或专业知识库。

虽然有上述能力扩展，但是它不像工作流那般定义清晰。这种隐式的调用，考验着AI应用开发者对于大模型的理解，并需要不断的迭代优化，才能最终获得期望的效果。

总结

今天学习一个新的组件”Agent”，并将工具模式设置为了”Function Calling”。有了它在AI应用开发中，能增强大模型的能力，可以对模型训练后发布之后的知识进行更新补充，不会再出现回答结果明显有时间断档的问题。

但是，这个能力又是一柄双刃剑。如果不了解其概念和知识，会发现很难驾驭它。

再也不用跑照相馆了！这个免费AI工具让你在家就能制作专业证件照

2025-07-23T12:32:13.000Z

朋友们！我发现了一个拍证件照的神器！#

你们有没有过这样的经历？

突然需要一张证件照，但是没时间去照相馆，或者觉得照相馆拍的不好看，又贵又麻烦。

前几天我要报名考试，需要一张蓝底证件照，但是外面下着大雨，根本不想出门。就在我急得团团转的时候，朋友给我推荐了一个叫 HivisionIDPhotos 的工具，简直救了我的命！

什么是 HivisionIDPhotos？#

说直白点，HivisionIDPhotos 就是一个用 AI 做证件照的工具，你只需要上传一张自己的照片，它就能自动帮你抠图、换背景、调整尺寸，生成各种规格的证件照，甚至还能美颜！

最棒的是，它可以完全离线运行，不用把照片上传到网上，超级安全！

为什么我这么喜欢 HivisionIDPhotos？#

1️⃣ 在家就能做，不用跑照相馆#

以前拍证件照，我都要专门抽时间去照相馆，排队等半天，拍出来的照片还不一定满意。现在好了，有了 HivisionIDPhotos，我在家用手机拍一张照片，上传进去，几分钟就能生成专业的证件照，太方便了！

2️⃣ 功能超级全#

这个工具能做的事情可多了：

自动抠图：不管你穿什么衣服，背景多复杂，都能精准把人抠出来
换背景：支持红、蓝、白等各种底色，还能自定义颜色
调整尺寸：支持各种证件照尺寸，比如一寸、二寸、护照照等
排版打印：可以生成六寸、五寸、A4等排版照，方便打印
美颜：自带美颜功能，让你看起来更精神
离线运行：所有处理都在本地完成，不用联网，保护隐私

我的使用体验#

前几天我用 HivisionIDPhotos 做了一张证件照，过程超级简单：

用手机对着白墙拍了一张照片
打开 HivisionIDPhotos 的网页
上传照片，选择一寸尺寸，蓝色背景
点击生成，等待几秒钟
下载生成的证件照

结果出来的照片超级专业，背景干净，人像清晰，比我在照相馆拍的还好看！

后来我还试了生成六寸排版照，打印出来刚好可以裁成8张一寸照片，省钱又方便。

怎么开始使用？#

Docker 部署#

创建一个 docker-compose.yml 文件，内容如下：

1
services:
2
  hivision_idphotos:
3
    image: linzeyi/hivision_idphotos:latest
4
    container_name: hivision_idphotos
5
    restart: unless-stopped
6
    ports:
7
      - "7861:7861"
8
    environment:
9
      - DEFAULT_LANG=zh
10
    command: python3 -u app.py --host 0.0.0.0 --port 7861

然后在文件所在目录运行：

Terminal window

1
docker-compose up -d

关于模型文件#

HivisionIDPhotos 需要使用一些 AI 模型来实现抠图、人脸检测等功能，主要包括：

抠图模型：MODNet、hivision_modnet、rmbg-1.4、birefnet-v1-lite
人脸检测模型：MTCNN、RetinaFace、Face++（在线）

模型文件说明#

使用官方 Docker 镜像：官方提供的 Docker 镜像已经内置了所需的模型文件，所以不需要单独下载模型
本地部署：如果选择本地部署，则需要通过以下命令下载模型：
Terminal window
```
1
python scripts/download_model.py --models all
```
下载的模型会保存在项目的 hivision/creator/weights 目录中

模型选择#

HivisionIDPhotos 支持多种模型组合，不同模型的性能和效果有所不同：

MODNet + MTCNN：内存占用小（约410MB），推理速度快（约0.2秒），适合配置较低的设备
birefnet-v1-lite + RetinaFace：内存占用较大（约6.2GB），推理速度较慢（约7秒），但分割精度更高

你可以根据自己设备的配置选择合适的模型组合。

适合谁用？#

学生党：经常需要各种证件照，又不想花钱去照相馆
上班族：需要证件照但没时间去照相馆
自由职业者：经常需要更新证件照
任何人：突然需要证件照应急

其他有趣的应用#

HivisionIDPhotos 还有一些社区开发的应用：

微信小程序：直接在微信里使用
ComfyUI 工作流：和其他 AI 工具结合使用
Windows 客户端：在电脑上更方便地使用
群晖/飞牛 NAS 部署：在 NAS 上运行，全家人都能用

总结#

HivisionIDPhotos 真的是一个超级实用的工具，它让拍证件照变得简单又省钱，不用再跑照相馆，在家就能做出专业的证件照。

如果你也经常需要证件照，或者不想为了一张证件照专门跑照相馆，一定要试试这个工具！

项目地址#

GitHub 仓库：https://github.com/Zeyi-Lin/HivisionIDPhotos

互动时间#

你们平时拍证件照都遇到过什么麻烦？用了 HivisionIDPhotos 后有什么感受？欢迎在评论区分享你的故事！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边需要证件照的朋友们～

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

Dify应用实战(2) - 联网工具

2025-07-23T12:32:13.000Z

前言#

让大家知道如何通过知识库的能力，获取指定的结果。这在很多的应用场景是非常有用的能力。
比如依赖有大量规则文档的行业，就会大大减少查找核对的工作。经常看到律师朋友，医生朋友发朋友圈说，AI不行啊，老是”胡说八道”，出现幻觉。
这其实是高估了大语言模型的能力，即使是垂直领域做过SFT，也不可能精确的回答准真正匹配规则的内容。并且微调训练成本也不低，不可能随时更新语料（标注数据）。通过RAG的方法，就可以在特定场景下，严格通过给出的文档内的规则，给出结果。

01. 动手做一做#

1
基于上一节课的流程，在大模型节点后新增一个工具节点，选择搜索"天气"，点中"高德天气预报"。
2

3
选择这个主要是前面知识库的地区名和code对照表，就是高德的。另外这个接口也比较简单，输入就是一个adcode，输出就是今天该地区的天气结果。

图片

1
添加之后，连接LLM节点和新增节点，再连接新增节点和结束节点。修改参数(一定要先连接)，"天气预报"的输入，选择"LLM"的text。然后把结束节点的输出也改为"天气预报"的text。
2

3
点击"发布"，保存。提示"操作成功"。就可以进行测试了。测试如下：

图片

02. 工具使用与开发#

1
一个正常应用的流程，其实都是非常复杂的。都需要经历很多步的操作，才能最终完成一项任务。
2

3
对于除大模型以外的工作，都需要工具进行配合。比如，大模型不可能直接得到今天某地的天气结果，需要通过API实时查询才行。那么通过LLM和天气预报工具进行结合，便实现了整个过程。
4

5
今天的任务，有现成的工具能使用。但是如果没有现有的工具，或者现有工具无法满足需求，就需要进行定制化开发。
6

7
基于Dify良好的设计，真要增加插件功能，还不算太难。不过这不是这一篇的重点，大概介绍一下吧。如果有兴趣，后面可以详谈。
8

9
通过扩展BuiltinTool类，将处理逻辑封装进"invoke tools"。最后返回create\_text\_message对象，包含处理后的数据或者异常信息，即可。

图片

总结#

1
今天在上次的工作流基础上，进一步增加外部工具获取数据的过程。并简单了解，实现类似功能的方法。为今后自己实际业务的开发奠定基础。

大模型的得力干将MCP(2) - 开发服务

2025-07-23T12:32:13.000Z

今天我们将继续学习，基于model context protocol的SDK来开发自己的MCP服务。

等系列课学习完成，你将能了解什么是MCP，如何开发MCP和如何实际使用它（当然我们会回归到Dify中，配合LLM，更加完善我们的AI应用适用场景）。

01.动手准备#

今天就来展开说说开发MCP应用，应该如何做。既然是开发，那就离不开代码了。处理的顺序正好和概念反过来，我们先来实现一个MCP服务端。

同时需要理解两个重要的概念：

1 通信机制#

MCP协议支持两种主要的通信机制：基于标准输入输出的本地通信和基于SSE(Server-Sent Events)的远程通信。

也就是说MCP服务端，根据和客户端连接时所在的位置不同，分成本地通信和远程通信。

本地通信是通过stdio传输数据，即数据是本地机器的进程间通信。适合AI助手工具等软件使用。

而远程通信则是利用SSE技术，通过HTTP来通信和传输数据。适合于共享MCP服务，在企业内使用或者服务给互联网用户。

2 运行语言和环境#

一般涉及到开发，必定是要和开发语言有关。但是MCP协议是和语言无关的，也就是说大家可以尽量使用自己熟悉的开发语言。

Anthropic提供了TypeScript SDK，Python SDK，Java SDK，C# SDK，甚至Swift SDK和Rust SDK。也就是说基本上任何语言都可以实现MCP服务。

为了降低难度，我们不用挑战从零开始，用全新的语言做开发，就从typescript-sdk开始吧。

02.动手做一做#

创建一个空的npm项目

1
npm init

输入如下信息

图片

修改package.json文件，增加依赖包和运行脚本。

图片

创建一个src目录并添加一个index.ts文件。内容如下，并替换自己的高德密钥。

1
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
3
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
4
import { z } from "zod";
5
import https from 'https';
6
// 环境变量中的API密钥
7
const GAODE_API_KEY = process.env.GAODE_API_KEY? process.env.GAODE_API_KEY: "高德密钥";
8
// 通用HTTP请求函数
9
async function makeRequest(url: string): Promise {
10
  return new Promise((resolve, reject) => {
11
    https.get(url, (res) => {
12
      let data = '';
13
      res.on('data', (chunk) => {
14
        data += chunk;
15
      });
16
      res.on('end', () => {
17
        try {
18
          resolve(JSON.parse(data));
19
        } catch (e) {
20
          reject(e);
21
        }
22
      });
23
    }).on('error', (err) => {
24
      reject(err);
25
    });
26
  });
27
}
28
// 创建MCP服务器
29
const server = new McpServer({
30
  name: "gaode-weather-mcp",
31
  version: "0.0.1"
32
});
33
// 实现天气查询
34
server.tool("getWeather",
35
  {
36
    city: z.string().describe("城市编码"),
37
    extensions: z.enum(["base", "all"]).optional().describe("气象类型：base(实况天气)、all(预报天气)")
38
  },
39
  async (params) => {
40
    if (!GAODE_API_KEY) {
41
      throw new Error("高德地图API密钥未设置");
42
    }
43
    const { city, extensions = "all" } = params;
44
    const url = `https://restapi.amap.com/v3/weather/weatherInfo?key=${GAODE_API_KEY}&city=${encodeURIComponent(city)}&extensions=${extensions}&output=json`;
45
    const result = await makeRequest(url);
46
    return {
47
      content: [{ type: "text", text: JSON.stringify(result) }]
48
    };
49
  }
50
);
51

52
// 启动服务器
53
async function main() {
54
  const transport = new StdioServerTransport();
55
  //const transport = new SSEServerTransport();
56
  await server.connect(transport);
57
  console.log("高德地图MCP服务已启动");
58
  // 保持运行
59
  await new Promise(() => { });
60
}
61

62
main().catch(console.error);

展开收起

这时在终端执行npm run build，会在src目录下编译生成index.js文件，这个就是MCP服务端代码了。

如果上一篇教程正常跑通，那这里就简单了，依葫芦画瓢。在Cursor的设置，添加一个新的MCP服务，或者通过.cursor/mcp.json增加。如下图：

图片

测试一下是否工作正常。切换到Agent模式，然后输入问题：“请问虹口区310109的天气怎么样？“。此时就会调用MCP tool getWeather，并得到正确的回答。

图片

03.补充说明#

MCP因为概念还比较新，各方的实现也是五花八门。特别是针对不同的语言，不同的运行环境(指的是Windows，Mac OS或者Linux)，支持的不同客户端(实际上是主机，含客户端，像Claude，Cursor，IDE等各种助手类软件)，想要自己本地跑起来第一个成功的案例，需要克服种种困难。

但是，随着MCP概念的兴起，这些问题会逐步解决。以后使用起来也会更加的顺滑，同时也给广大的开发者，带了很多新的机会，早期介入都会有红利期。

麦金叔也是非常感谢读者粉丝们的热情支持，期望大家都能从这一系列的讲解中，得到一个清晰的认识。同时意识到，做这些的技术并非凭空出现的，比如node开发，SSE技术，实际上都已经是比较成熟的东西。但是嫁接到MCP上，又能焕发出第二春。

虽然当前的SSE应用在MCP架构上，也是有不同的声音，比如认证，单向通讯等问题限制了一定的使用场景。但如果一切都已经那么完美了，那参与开发的人也就没有发展的空间了，是不是呢？

总结

今天学习了第一个自动实现的MCP服务，高德天气查询的例子。理解最简单的MCP服务开发的方法。但是，还有更多的MCP的概念没有引入，后面的文章将继续探讨，敬请期待。

Dify应用实战番外 - 网友提问(1)

2025-07-23T12:32:13.000Z

这两天有网友问，上次的课提到了数据库查询，对一般的人还是有点难度。所以希望大模型也能生成SQL，可以自己去查询数据库的数据。

麦金叔建议他使用文生SQL的模型，网友应该真的去尝试了，只不过还是有问题。那今天麦金叔就来演示一下，如何处理这一需求，并解决查询报错的问题。

01.动手做一做#

今天的任务专题是解决让大模型生成SQL查询语句，并利用数据库工具查询得到结果。

依然用工作流作为测试。添加下图所示节点，依次为”开始”，“LLM”，“参数提取器”，“SQL EXECUTE”和”结束”。

图片

将”开始”节点，添加一个参数”user_promt”。这样在对话时，可以将查询要求填入。

“LLM”节点选择模型为”qwen2.5-72b-instruct”，上下文选择”开始”节点新增的参数”user_promt”，将系统提示词按如下填入：

请直接提供答案，无需解释思考过程。

根据用户输入上下文

进行SQL的生成，最终结果仅包含SQL语句。

数据库的schema如下：

1
CREATE TABLE `doctor` (
2

3
 `id` int(11) NOT NULL,
4

5
 `name` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL,
6

7
 `title` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL,
8

9
 `department` varchar(255) COLLATE utf8mb4_bin DEFAULT NULL,
10

11
 `description` text COLLATE utf8mb4_bin,
12

13
 `status` tinyint(2) DEFAULT NULL,
14

15
 PRIMARY KEY (`id`),
16

17
 KEY `dep` (`department`) USING BTREE
18

19
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

展开收起

其中status为医生工作状态，1表示医生正常工作，0表示医生暂停诊治。

title为医生的职称，description为医生擅长领域。

接着在”参数提取器”节点配置模型为”qwen2.5-32b-Instruct”，输入选择上一个”LLM”节点的text。

新建一个提取参数”sql_query”，指令部分填入：

忽略大模型输出的思考过程，即不要提取部分

图片

“SQL EXECUTE”节点，保持和12节课数据库查询一致，并在”结束”节点输出查询结果。

保存后进行测试，结果如下图：

图片

02.解释说明#

首先，需要添加一个”参数提取器”。因为大模型文生SQL的结果会是这样的结果：

1
{
2

3
  "text": "\`\`\`sql\\nSELECT name, title, description \\nFROM doctor \\nWHERE department = '眼科' AND status = 1;\\n\`\`\`"
4

5
}

可以看到text的内容，是以sql开头的。那如果直接去运行，肯定不行呀。SQL查询语句还是需要严谨的，否则无法执行数据库查询。

当然，如果使用其他方法，比如”代码”或者”模版”也可以的，但都比”参数提取器”复杂。

其次，模型的选择上，“LLM”最后不要使用带有COT的模型，因为这一类模型强大是强大，还输出了思考过程，但只是给人看友好。而在工作流里面，还要进一步处理它，比较麻烦。还是直接用输出结果，而不给出思考过程的，更适合工作流。

最后，本着够用就行的原则，对问题理解并生成结果的模型需要参数大一些的模型，但是参数提取这种工作，就没必要也用参数大的，可以适当减小。毕竟实际工作中，在效果一致的前提下，能省一点是一点。

总结

今天的答疑来自网友的留言问题，实际上学习AI应用开发，一定不能照本宣科。要不断地尝试，碰到问题，并解决它，才能学以致用，为工作中能用上AI的能力打下坚实的基础。

太爽了！这个免费工具让你的小说变成有声书，再也不用盯着屏幕看了

2025-07-23T12:32:13.000Z

朋友们！我发现了一个听书神器！#

你们有没有过这样的经历？

想读小说，但是眼睛看久了不舒服；开车或运动的时候，想看书却腾不出手；或者只是想放松一下，闭着眼睛听点什么。

前几天我在网上发现了一个叫 easyVoice 的工具，简直打开了新世界的大门！它能把文本转换成语音，而且效果超级自然，就像真人在朗读一样。今天必须强烈安利给你们！

什么是 easyVoice？#

说直白点，easyVoice 就是一个开源的文本转语音工具，它能把文字内容转换成自然流畅的语音，让你可以用耳朵“阅读”，而不是用眼睛。

为什么我这么喜欢 easyVoice？#

1️⃣ 免费无限制，想转多少转多少#

最重要的是，easyVoice 完全免费，而且没有字数限制！不管你的文本有多长，都能一次性转换，不像有些工具只能转几百字就要收费。

2️⃣ 多角色配音，听着更有趣#

它支持多角色配音，比如小说里有不同的人物对话，它能给不同的角色分配不同的声音，听起来就像在听广播剧一样，超级有代入感！

3️⃣ 效果自然，不像机器人#

以前我也用过一些文本转语音工具，但是声音听起来很机械，没有感情。easyVoice 就不一样了，它的声音非常自然，有抑扬顿挫，就像真人在朗读一样。

4️⃣ 可以部署在自己的设备上#

如果你担心隐私问题，或者想随时随地使用，easyVoice 可以部署在自己的电脑、服务器或 NAS 上，所有数据都在本地，超级安全！

我的使用体验#

前几天我用 easyVoice 转换了一本我一直在追的小说，效果真的惊艳到我了：

打开 easyVoice 的网页界面
复制粘贴小说内容
选择合适的声音和语速
点击转换按钮
等待几分钟，下载生成的音频文件

结果生成的音频超级自然，我听了一个小时都不觉得累，而且还能边听边做其他事情，效率高了不少！

后来我还试了用它转换一些工作文档，在通勤路上听，既节省了时间，又保护了眼睛，简直一举两得！

怎么开始使用？#

方法一：直接体验在线版本#

如果你不想部署，也可以直接访问在线体验地址：https://easyvoice.ioplus.tech/

方法二：Docker 部署#

如果你想在自己的设备上部署，可以使用 Docker：

确保你的设备上安装了 Docker

运行命令：

Terminal window

1
docker run -d --name easyvoice -p 5666:5666 cosin2077/easyvoice

打开浏览器访问 http://你的设备IP:5666

适合谁用？#

小说爱好者：不想盯着屏幕看，想闭着眼睛听小说
上班族：通勤路上想学习或听文档，解放双手和眼睛
学生党：听课本内容，提高学习效率
视障人士：通过语音“阅读”文字内容
任何人：想把文字转换成语音的人

其他功能#

除了基本的文本转语音功能，easyVoice 还有一些其他实用功能：

批量转换：可以一次性转换多个文本文件
调整语速：根据个人喜好调整语音速度
多种声音选择：提供多种不同的声音供选择
音频格式输出：支持多种音频格式输出

总结#

easyVoice 真的是一个超级实用的工具，它让阅读变得更加轻松和便捷，尤其是对于那些长时间盯着屏幕的人来说，简直是福音！

如果你也想解放眼睛，用耳朵“阅读”，一定要试试 easyVoice，相信你会和我一样爱上它的！

项目地址#

GitHub 仓库：https://github.com/cosin2077/easyVoice
在线体验：https://easyvoice.ioplus.tech/

互动时间#

你们平时喜欢听有声书吗？用了 easyVoice 后有什么感受？欢迎在评论区分享你的故事！

如果觉得这篇文章有用，别忘了点赞、在看并分享给身边喜欢听书的朋友们～

（注：文章部分信息来源于项目官方文档和个人使用体验）

Dify应用实战(6) - 图片生成(上)

2025-07-23T12:32:13.000Z

有了这些内容，兵分两路，一路去生成语音播报，另一路就去生成图片内容。
学习完成，你将掌握如何对图片进行布局，控制使用背景图，不同区域生成指定文字内容。

01.动手做一做#

大家通过之前的教程，已经有了基本的使用Dify节点的能力，所以这一节课，就一次性多来点。不过因为加的东西有点多，涉及到的知识有点过载，所以还是分两篇吧。
基于上一节课的流程，在”模版转换”节点之后，再新增四个”模版转换”的节点，之后来一个”HTTP请求”和”代码执行”节点。

图片

1
添加之后，以上节点都连起来，然后按下面图示，进行设置。（如有需求，可扫描文末助手添加好友，发送"Dify图片制作"，获取DSL文件）

图片

其中，编号1，2，3实际上是拼凑出一个JSON请求体，供”HTTP请求”节点使用。注意每段都不是正常的JSON完整体，有缺闭口的，有多一个逗号或者闭合大括号的。但在最后一次Jinja模版拼凑(编号4)之后，就是一个完整的JSON了。

最后经过HTTP请求(编号5。如果不会，也不用担心，下篇会手把手教，所以为了防止走失，还是关注一下吧)之后，再在”代码执行”(编号6)里把结果图片的地址解析出来，整个流程就算结束了。

点击”发布”，保存。提示”操作成功”，就可以进行测试了。测试如下：

图片

结果输出是一个图片结果的URL。手动打开URL得到一张图内容如下：

图片

02.补充说明#

今天的任务，一样非常简单，但为什么是中高级水平呢？原因是，这里需要超级耐心和仔细，并且要有http请求的基本概念。
同时还有两个第三方服务，一个是imgrender，另一个是figma。
下篇，麦金叔会仔细讲解里面涉及到的东西，请大家耐心等待一天。保证能让小白都会使用的。

总结

今天在上次的工作流基础上，进一步将文案内容，生成到带有底图背景的图片中，最终成品如何，就依赖各位的设计能力了。

Dify应用实战番外 - 网友提问(3)

2025-07-23T12:32:13.000Z

最近还是有网友问，代码执行节点为啥运行报错，说找不到模块。但自己的Python环境是安装了这些模块的。还有就是按照麦金叔的数据库连接，为啥连不上。今天我们再详细说说。

01.库和权限#

当你运行代码节点出现如下两种错误的时候，这一篇就是为你准备的。

图片

最简单的方式就是在Dify的沙箱环境进行依赖库的安装和权限设置。

库安装：

工程目录下docker/volumes/sandbox/dependencies下有一个空文件python-requirements.txt，打开文件后

增加一行”pandas==2.2.3”，如果你代码使用了其他第三方库，也像正常pip install或者conda install一样，将使用的库，依次添加即可。

图片

权限修改：

工程目录下docker/volumes/sandbox/conf里面有一个config.yaml文件，找到allowed_syscalls段，把需要的权限加进去。

图片

还是有同学不知道怎么操作，也有不放心权限太大的，麦金叔把所有的code和解释都放这里，自己按需裁剪。

1
app:
2
  port:8194
3
  debug:True
4
  key:dify-sandbox
5
max_workers:4
6
max_requests:50
7
worker_timeout:5
8
python_path:/usr/local/bin/python3
9
enable_network:True# please make sure there is no network risk in your environment
10
allowed_syscalls:# please leave it empty if you have no idea how seccomp works
11
  # 基础文件操作
12
  -0   # read - 从文件描述符读取数据
13
  -1   # write - 向文件描述符写入数据
14
  -2   # open - 打开文件
15
  -3   # close - 关闭文件描述符
16
  -4   # stat - 获取文件状态
17
  -5   # fstat - 获取文件描述符状态
18
  -6   # lstat - 获取符号链接状态
19
  -7   # poll - 等待文件描述符上的事件
20
  -8   # lseek - 重新定位读/写文件偏移量
21
  -9   # mmap - 将文件或设备映射到内存
22
  -10  # mprotect - 设置内存区域的保护
23
  -11  # munmap - 取消内存映射
24
  -12  # brk - 改变数据段大小
25
  # 系统操作
26
  -13  # rt_sigaction - 检查或修改信号处理
27
  -14  # rt_sigprocmask - 检查或修改阻塞信号
28
  -15  # rt_sigreturn - 从信号处理程序返回
29
  -16  # ioctl - 控制设备
30
  -17  # pread64 - 从指定偏移量读取
31
  -18  # pwrite64 - 向指定偏移量写入
32
  -19  # readv - 从文件描述符读取数据到多个缓冲区
33
  -20  # writev - 从多个缓冲区写入数据到文件描述符
34
  -21  # access - 检查文件访问权限
35
  -22  # pipe - 创建管道
36
  -23  # select - 同步 I/O 多路复用
37
  -24  # sched_yield - 让出处理器
38
  -25  # mremap - 重新映射虚拟内存地址
39
  # 高级内存管理
40
  -26  # msync - 同步内存与物理存储
41
  -27  # mincore - 确定内存页是否驻留在内存中
42
  -28  # madvise - 给出内存使用建议
43
  -29  # shmget - 获取共享内存段
44
  -30  # shmat - 附加共享内存段
45
  -31  # shmctl - 共享内存控制
46
  -32  # dup - 复制文件描述符
47
  -33  # dup2 - 复制文件描述符到指定编号
48
  -34  # pause - 挂起进程直到收到信号
49
  # 进程管理
50
  -35  # nanosleep - 高精度睡眠
51
  -36  # getitimer - 获取定时器值
52
  -37  # alarm - 设置定时器
53
  -38  # setitimer - 设置定时器
54
  -39  # getpid - 获取进程ID
55
  -40  # sendfile - 在文件描述符之间传输数据
56
  # 网络操作
57
  -41  # socket - 创建套接字
58
  -42  # connect - 初始化套接字连接
59
  -43  # accept - 接受套接字连接
60
  -44  # sendto - 通过套接字发送消息
61
  -45  # recvfrom - 从套接字接收消息
62
  -46  # sendmsg - 通过套接字发送消息
63
  -47  # recvmsg - 通过套接字接收消息
64
  -48  # shutdown - 关闭套接字连接
65
  -49  # bind - 绑定套接字到地址
66
  -50  # listen - 监听套接字连接
67
  # 进程间通信
68
  -51  # getsockname - 获取套接字本地地址
69
  -52  # getpeername - 获取套接字对端地址
70
  -53  # socketpair - 创建一对已连接的套接字
71
  -54  # setsockopt - 设置套接字选项
72
  -55  # getsockopt - 获取套接字选项
73
  # 进程控制
74
  -56  # clone - 创建子进程
75
  -57  # fork - 创建进程
76
  -58  # vfork - 创建进程并阻塞父进程
77
  -59  # execve - 执行程序
78
  -60  # exit - 终止进程
79
  -61  # wait4 - 等待进程改变状态
80
  -62  # kill - 发送信号
81
  # 信号处理
82
  -63  # uname - 获取系统信息
83
  -64  # semget - 获取信号量集
84
  -65  # semop - 信号量操作
85
  -66  # semctl - 信号量控制
86
  -67  # shmdt - 分离共享内存段
87
  -68  # msgget - 获取消息队列
88
  -69  # msgsnd - 发送消息到队列
89
  -70  # msgrcv - 从队列接收消息
90
  -71  # msgctl - 消息队列控制
91
  # 文件系统操作
92
  -72  # fcntl - 文件描述符控制
93
  -73  # flock - 应用或删除文件锁
94
  -74  # fsync - 同步文件到存储设备
95
  -75  # fdatasync - 同步文件数据
96
  -76  # truncate - 截断文件
97
  -77  # ftruncate - 截断文件描述符指向的文件
98
  -78  # getdents - 获取目录项
99
  -79  # getcwd - 获取当前工作目录
100
  -80  # chdir - 改变当前工作目录
101
  # 文件系统管理
102
  -81  # fchdir - 通过文件描述符改变当前工作目录
103
  -82  # rename - 重命名文件
104
  -83  # mkdir - 创建目录
105
  -84  # rmdir - 删除目录
106
  -85  # creat - 创建新文件
107
  -86  # link - 创建硬链接
108
  -87  # unlink - 删除文件名
109
  -88  # symlink - 创建符号链接
110
  -89  # readlink - 读取符号链接的值
111
  -90  # chmod - 改变文件权限
112
  # 权限和所有权
113
  -91  # fchmod - 改变文件描述符的权限
114
  -92  # chown - 改变文件所有者和组
115
  -93  # fchown - 改变文件描述符指向文件的所有者和组
116
  -94  # lchown - 改变符号链接的所有者和组
117
  -95  # umask - 设置文件模式创建掩码
118
  # 系统信息和统计
119
  -96  # gettimeofday - 获取时间和日期
120
  -97  # getrlimit - 获取资源限制
121
  -98  # getrusage - 获取资源使用情况
122
  -99  # sysinfo - 获取系统统计信息
123
  -100# times - 获取进程时间
124
  # 系统控制
125
  -101# ptrace - 进程跟踪
126
  -102# getuid - 获取用户ID
127
  -103# syslog - 读取或清除内核消息
128
  -104# getgid - 获取组ID
129
  -105# setuid - 设置用户ID
130
  -106# setgid - 设置组ID
131
  # 用户和组管理
132
  -107# geteuid - 获取有效用户ID
133
  -108# getegid - 获取有效组ID
134
  -109# setpgid - 设置进程组
135
  -110# getppid - 获取父进程ID
136
  -111# getpgrp - 获取进程组ID
137
  # 会话管理
138
  -112# setsid - 创建会话并设置进程组ID
139
  -113# setreuid - 设置实际和有效用户ID
140
  -114# setregid - 设置实际和有效组ID
141
  -115# getgroups - 获取附加组ID
142
  -116# setgroups - 设置附加组ID
143
  # 系统资源管理
144
  -117# setresuid - 设置实际、有效和保存的用户ID
145
  -118# getresuid - 获取实际、有效和保存的用户ID
146
  -119# setresgid - 设置实际、有效和保存的组ID
147
  -120# getresgid - 获取实际、有效和保存的组ID
148
  # 系统时间管理
149
  -121# getpgid - 获取进程组ID
150
  -122# setfsuid - 设置文件系统用户ID
151
  -123# setfsgid - 设置文件系统组ID
152
  -124# getsid - 获取会话ID
153
  -125# capget - 获取进程权能
154
  -126# capset - 设置进程权能
155
  # 实时调度
156
  -127# rt_sigpending - 检查待处理信号
157
  -128# rt_sigtimedwait - 同步等待信号
158
  -129# rt_sigqueueinfo - 排队一个信号和数据
159
  -130# rt_sigsuspend - 等待信号
160
  # 高级进程管理
161
  -131# sigaltstack - 设置和获取信号栈上下文
162
  -132# utime - 改变文件的访问和修改时间
163
  -133# mknod - 创建特殊文件
164
  -134# uselib - 加载共享库
165
  -135# personality - 设置进程执行域
166
  # 系统调用
167
  -136# ustat - 获取文件系统统计信息
168
  -137# statfs - 获取文件系统信息
169
  -138# fstatfs - 获取文件系统信息
170
  -139# sysfs - 获取文件系统类型信息
171
  -140# getpriority - 获取程序调度优先级
172
  # 进程优先级
173
  -141# setpriority - 设置程序调度优先级
174
  -142# sched_setparam - 设置调度参数
175
  -143# sched_getparam - 获取调度参数
176
  -144# sched_setscheduler - 设置调度策略和参数
177
  -145# sched_getscheduler - 获取调度策略
178
  # 调度策略
179
  -146# sched_get_priority_max - 获取静态优先级上限
180
  -147# sched_get_priority_min - 获取静态优先级下限
181
  -148# sched_rr_get_interval - 获取时间片
182
  -149# mlock - 锁定内存页
183
  -150# munlock - 解锁内存页
184
  # 内存锁定
185
  -151# mlockall - 锁定进程的地址空间
186
  -152# munlockall - 解锁进程的地址空间
187
  -153# vhangup - 虚拟挂起终端
188
  -154# modify_ldt - 读取或写入本地描述符表
189
  -155# pivot_root - 改变根文件系统
190
  # 系统引导
191
  -156# _sysctl - 读取/写入系统参数
192
  -157# prctl - 操作进程或线程
193
  -158# arch_prctl - 设置架构特定的线程状态
194
  -159# adjtimex - 调整系统时钟
195
  # 文件系统控制
196
  -161# chroot - 改变根目录
197
  -162# sync - 同步文件系统缓冲区
198
  -163# acct - 切换进程记账
199
  -164# settimeofday - 设置时间和日期
200
  -165# mount - 挂载文件系统
201
  # 系统维护
202
  -166# umount2 - 卸载文件系统
203
  -167# swapon - 开启交换设备和文件
204
  -168# swapoff - 关闭交换设备和文件
205
  -169# reboot - 重新启动系统
206
  -170# sethostname - 设置系统主机名
207
  # 网络配置
208
  -171# setdomainname - 设置系统域名
209
  -172# iopl - 改变I/O权限级别
210
  -173# ioperm - 设置端口I/O权限
211
  -174# create_module - 创建可加载的模块项
212
  -175# init_module - 初始化内核模块
213
  # 内核模块
214
  -176# delete_module - 删除内核模块
215
  -177# get_kernel_syms - 检索导出的内核符号
216
  -178# query_module - 查询内核模块信息
217
  -179# quotactl - 操作文件系统配额
218
  -180# nfsservctl - NFS服务器控制
219
  # 系统信息查询
220
  -181# getpmsg - 接收控制消息
221
  -182# putpmsg - 发送控制消息
222
  -183# afs_syscall - 未实现的系统调用
223
  -184# tuxcall - 未实现的系统调用
224
  -185# security - 未实现的系统调用
225
  # 新增系统调用
226
  -186# gettid - 获取线程标识符
227
  -187# readahead - 预读文件到页面缓存
228
  -188# setxattr - 设置扩展属性
229
  -189# lsetxattr - 设置符号链接的扩展属性
230
  -190# fsetxattr - 设置文件描述符的扩展属性
231
  # 扩展属性操作
232
  -191# getxattr - 获取扩展属性
233
  -192# lgetxattr - 获取符号链接的扩展属性
234
  -193# fgetxattr - 获取文件描述符的扩展属性
235
  -194# listxattr - 列出扩展属性
236
  -195# llistxattr - 列出符号链接的扩展属性
237
  # 高级文件系统特性
238
  -196# flistxattr - 列出文件描述符的扩展属性
239
  -197# removexattr - 删除扩展属性
240
  -198# lremovexattr - 删除符号链接的扩展属性
241
  -199# fremovexattr - 删除文件描述符的扩展属性
242
  -200# tkill - 发送信号到线程
243
  # 时间管理
244
  -201# time - 获取时间
245
  -202# futex - 快速用户空间锁定
246
  -203# sched_setaffinity - 设置进程的CPU亲和性掩码
247
  -204# sched_getaffinity - 获取进程的CPU亲和性掩码
248
  -205# set_thread_area - 设置线程本地存储
249
  # 进程/线程控制
250
  -206# io_setup - 创建异步I/O上下文
251
  -207# io_destroy - 销毁异步I/O上下文
252
  -208# io_getevents - 从完成队列读取异步I/O事件
253
  -209# io_submit - 提交异步I/O块
254
  -210# io_cancel - 取消异步I/O操作
255
  # 异步I/O
256
  -211# get_thread_area - 获取线程本地存储
257
  -212# lookup_dcookie - 获取目录cookie的路径
258
  -213# epoll_create - 创建epoll实例
259
  -214# epoll_ctl_old - 旧的epoll控制接口
260
  -215# epoll_wait_old - 旧的epoll等待接口
261
  # 事件通知
262
  -216# remap_file_pages - 创建非线性文件映射
263
  -217# getdents64 - 获取目录项（64位版本）
264
  -218# set_tid_address - 设置清除子线程ID的地址
265
  -219# restart_syscall - 重启被中断的系统调用
266
  -220# semtimedop - 带超时的信号量操作
267
  # 定时器和时钟
268
  -221# fadvise64 - 预声明访问模式
269
  -222# timer_create - 创建POSIX定时器
270
  -223# timer_settime - 设置定时器的时间
271
  -224# timer_gettime - 获取定时器的时间
272
  -225# timer_getoverrun - 获取定时器超限次数
273
  # POSIX定时器
274
  -226# timer_delete - 删除POSIX定时器
275
  -227# clock_settime - 设置指定时钟的时间
276
  -228# clock_gettime - 获取指定时钟的时间
277
  -229# clock_getres - 获取时钟精度
278
  -230# clock_nanosleep - 高精度睡眠
279
  # 进程终止
280
  -231# exit_group - 终止所有线程
281
  -232# epoll_wait - 等待epoll事件
282
  -233# epoll_ctl - 控制epoll实例
283
  -234# tgkill - 发送信号到线程
284
  -235# utimes - 更改文件访问和修改时间
285
  # 虚拟内存操作
286
  -236# vserver - Linux-VServer操作
287
  -237# mbind - 设置内存策略
288
  -238# set_mempolicy - 设置NUMA内存策略
289
  -239# get_mempolicy - 检索NUMA内存策略
290
  -240# mq_open - 打开消息队列
291
  # POSIX消息队列
292
  -241# mq_unlink - 删除消息队列
293
  -242# mq_timedsend - 发送消息到队列
294
  -243# mq_timedreceive - 从队列接收消息
295
  -244# mq_notify - 注册消息队列通知
296
  -245# mq_getsetattr - 获取/设置消息队列属性
297
  # 密钥管理
298
  -246# kexec_load - 加载新内核
299
  -247# waitid - 等待进程状态改变
300
  -248# add_key - 添加密钥到内核密钥管理系统
301
  -249# request_key - 请求操作密钥
302
  -250# keyctl - 密钥管理控制
303
  # 输入输出多路复用
304
  -251# ioprio_set - 设置I/O调度优先级
305
  -252# ioprio_get - 获取I/O调度优先级
306
  -253# inotify_init - 初始化inotify实例
307
  -254# inotify_add_watch - 添加inotify监视
308
  -255# inotify_rm_watch - 删除inotify监视
309
  # 文件系统监控
310
  -256# migrate_pages - 在NUMA系统中迁移进程页
311
  -257# openat - 相对路径打开文件
312
  -258# mkdirat - 相对路径创建目录
313
  -259# mknodat - 相对路径创建特殊文件
314
  -260# fchownat - 相对路径改变所有权
315
  # 相对路径操作
316
  -261# futimesat - 相对路径更改时间戳
317
  -262# newfstatat - 相对路径获取文件状态
318
  -263# unlinkat - 相对路径删除文件
319
  -264# renameat - 相对路径重命名
320
  -265# linkat - 相对路径创建硬链接
321
  # 符号链接操作
322
  -266# symlinkat - 相对路径创建符号链接
323
  -267# readlinkat - 相对路径读取符号链接
324
  -268# fchmodat - 相对路径改变权限
325
  -269# faccessat - 相对路径检查访问权限
326
  -270# pselect6 - 改进的select系统调用
327
  # 高级I/O操作
328
  -271# ppoll - 改进的poll系统调用
329
  -272# unshare - 解除共享命名空间
330
  -273# set_robust_list - 设置健壮的futex列表
331
  -274# get_robust_list - 获取健壮的futex列表
332
  -275# splice - 在文件描述符之间移动数据
333
  # 零拷贝操作
334
  -276# tee - 复制管道数据
335
  -277# sync_file_range - 同步文件段
336
  -278# vmsplice - 在进程和内核之间传输数据
337
  -279# move_pages - 在NUMA系统中移动页面
338
  -280# utimensat - 相对路径更改文件时间戳
339
  # 事件通知
340
  -281# epoll_pwait - 等待epoll事件，可中断
341
  -282# signalfd - 创建信号接收文件描述符
342
  -283# timerfd_create - 创建定时器文件描述符
343
  -284# eventfd - 创建事件通知文件描述符
344
  -285# fallocate - 预分配文件空间
345
  # 定时器操作
346
  -286# timerfd_settime - 设置定时器文件描述符
347
  -287# timerfd_gettime - 读取定时器文件描述符
348
  -288# accept4 - 接受带标志的连接
349
  -289# signalfd4 - 改进的signalfd
350
  -290# eventfd2 - 改进的eventfd
351
  # 文件系统操作
352
  -291# epoll_create1 - 改进的epoll_create
353
  -292# dup3 - 改进的dup2
354
  -293# pipe2 - 改进的pipe
355
  -294# inotify_init1 - 改进的inotify_init
356
  -295# preadv - 向量化的pread
357
  # 向量I/O操作
358
  -296# pwritev - 向量化的pwrite
359
  -297# rt_tgsigqueueinfo - 排队实时信号到线程组
360
  -298# perf_event_open - 性能监控
361
  -299# recvmmsg - 接收多个消息
362
  -300# fanotify_init - 初始化fanotify
363
  # 文件系统通知
364
  -301# fanotify_mark - 管理fanotify标记
365
  -302# prlimit64 - 获取/设置资源限制
366
  -303# name_to_handle_at - 文件句柄操作
367
  -304# open_by_handle_at - 通过文件句柄打开
368
  -305# clock_adjtime - 调整系统时钟
369
  # 同步操作
370
  -306# syncfs - 同步文件系统
371
  -307# sendmmsg - 发送多个消息
372
  -308# setns - 设置命名空间
373
  -309# getcpu - 获取CPU和NUMA节点
374
  -310# process_vm_readv - 进程间读取数据
375
  # 进程间通信
376
  -311# process_vm_writev - 进程间写入数据
377
  -312# kcmp - 内核比较两个进程
378
  -313# finit_module - 从文件描述符加载内核模块
379
  -314# sched_setattr - 设置调度属性
380
  -315# sched_getattr - 获取调度属性
381
  # 安全计算
382
  -316# renameat2 - 扩展的重命名操作
383
  -317# seccomp - 设置安全计算模式
384
  -318# getrandom - 获取随机数
385
  -319# memfd_create - 创建匿名文件
386
  -320# kexec_file_load - 从文件加载新内核
387
  # 命名空间操作
388
  -321# bpf - 扩展的BPF系统调用
389
  -322# execveat - 相对路径执行程序
390
  -323# userfaultfd - 用户页错误处理
391
  -324# membarrier - 发出内存屏障
392
  -325# mlock2 - 改进的内存锁定
393
  # 套接字操作
394
  -326# copy_file_range - 复制文件范围
395
  -327# preadv2 - 带标志的向量化pread
396
  -328# pwritev2 - 带标志的向量化pwrite
397
  -329# pkey_mprotect - 设置内存保护键
398
  -330# pkey_alloc - 分配内存保护键
399
  # 内存保护
400
  -331# pkey_free - 释放内存保护键
401
  -332# statx - 扩展的文件状态
402
  -333# io_pgetevents - 获取异步I/O事件
403
  -334# rseq - 重启序列
404
  -335# pidfd_send_signal - 通过文件描述符发送信号
405
proxy:
406
  socks5:''
407
  http:''
408
  https:''

展开收起

02.数据库连接#

数据库连接不上也是麦金叔粉丝里面问的比较多的问题，但是各种情况都有。写出来是为了后面再有类似问题的朋友，可以对号自行解决。

1.从dify.ai企图连接本地数据库

这个问题，不是不能解决，但主要吧，是没有理解网络的访问到底是咋回事。

就给两个解决方案吧。

第一个方案，可以从云服务商那里购买一个ECS装个可以公网访问的数据库(mysql或者postgres)，或者直接就买mysql数据库。这样得到了公网访问的数据库连接地址。就可以在dify.ai的工作流里面配置连接了。当然需要注意数据库暴露在公网上，要进行安全配置，否则很容易被别人滥用。

第二个方案，离开dify.ai。自己本地搭一个dify的环境。参考这篇文章。

AI实践之Plan B：本地搭建运行环境(3)

最后的方案，是通过本地的端口代理，让dify.ai可以访问本地的数据库，但是这个不推荐一般人用了。除非你真的想学习使用，那就后台找小助手吧。

2.本地localhost连接不上

因为大家使用docker或者docker compose来部署dify，所在的环境不同。特别是使用windows的，正常的localhost有时候连不上docker内的数据库。

这是docker的网络问题，可以把uri中的localhost改成host.docker.internal，尝试一下。

如果还是不行，那就找到本地局域网地址（如192.168.xxx，172.16.xxx等），再尝试。

3.Internal Server Error

图片

这种因为粉丝朋友也没有提供非常有效的信息。但可以尝试卸载database插件。重启后，再重新安装database插件来解决。貌似问这个粉丝后面就好了。

4.授权错误

图片

绝大部分报这个非法授权问题，都是因为database插件连不上数据库导致的。实际上可以参考上面第1，第2条解决。但是有时候并不是数据库连不上，而是uri没写对。注意格式，另外最新版本的插件已经可以支持mysql，postgres，sqlite，mssql和oracle了。

1
mysql+pymysql://root:123456@localhost:3306/test
2
postgresql+psycopg2://postgres:123456@localhost:5432/test
3
sqlite:///test.db
4
mssql+pymssql://:@/?charset=utf8
5
oracle+oracledb://user:pass@hostname:port[/dbname][?service_name=[&key=value&key=value...]]

格式如上，数据库类型+驱动，然后冒号后双斜杠，用户名，密码，再是数据库地址和端口，最后使用的数据库库名也要写上。

总结

今天的答疑全部来自网友的留言问题，有些错误是麦金叔未成设想到的。不过这也给麦金叔提了个醒，很多人其实愿意尝试动手做的，但是因为这当中有非常多的困难，不知道哪一个问题就会困住。然后就放弃了，其实也许再坚持一下，问一问，查一查，就解决了。

麦金叔当初写这一些列的文章的时候，就没想着要搞知识付费，真心希望粉丝们，能都踏上AI应用的东风，为自己提高职场竞争力。当然，能顺手点个赞，收藏，转发一下，麦金叔也是非常高兴的。

大模型的得力干将MCP(1) - 基础入门

2025-07-23T12:32:13.000Z

上一节Dify应用实战课，我们学习了如何将数据表生成图，可以更直接的展示数据的意义。

今天我们将暂时将Dify的学习搁置一下。来学习AI工具中重要的一个知识：MCP(Model Context Protocol)。

等系列课学习完成，你将能了解什么是MCP，如何开发MCP和如何实际使用它（当然我们会回归到Dify中，配合LLM，更加完善我们的AI应用适用场景）。

01.基础概念#

MCP(Model Context Protocol)是一种开放协议，它标准化了应用程序如何为LLM提供上下文。

将MCP想象成AI应用程序的USB-C端口。正如USB-C提供了一种将设备连接到各种外围设备和配件的标准化方式一样，MCP也提供了一种将AI模型连接到不同数据源和工具的标准化方式。

它是去年11月才被Claude公司提出来的，但是不到半年时间，基于MCP的生态就如雨后春笋般涌现。过去以API方式提供服务的传统互联网，迅速拥抱这一变化，大量的MCP服务被开发，开源和提供出来。

要想开发MCP应用，首先需要了解的是其架构和几个重要的概念。

图片

简单的图示中，提到了主机，客户端和服务器。

1 主机#

MCP主机(MCP Hosts)：发起请求的LLM应用程序(例如Cursor、IDE或AI工具)。

其中核心的能力就是LLM有Function Calling的能力，但是为了解决现有Function Calling的使用过程中，需要与LLM节点绑定的问题，便通过剥离的方式，让其成为一个钩子，配合其他两个部分来完成任务。

2 客户端#

MCP客户端(MCP Clients)：在主机程序内部，与MCP server保持1<1的连接>。

通过MCP的协议，通常有两种形式：stdio和sse的方式与服务器进行连接通信。后面也会解释这两种方式的区别和优缺点。

3 服务器#

MCP服务器(MCP Servers)：为MCP client提供上下文、工具和prompt信息。

服务器类似原先提供API服务的模块，它与本地文件，数据库或者其他公共服务API进行交互，来最终完成数据处理或者信息查询等工作，并提供结果数据。

通过以上几个组件的拆解，LLM就能像调用Function Calling一样，完成特定任务的处理。而MCP Servers可形成公共服务，不必直接绑定到特定LLM节点。

02.动手做一做#

为了测试，我们需要先准备一个MCP Server。在不清楚如何使用的前提下，我们可以使用现成的开源项目。如下，是一个查询应用程序版本的服务。

图片

1
//安装命令
2
npm install mcp-package-version -g
3

4
//配置JSON
5
{
6
"mcpServers": {
7
    "mcp-package-version": {
8
      "command": "node",
9
      "args": [
10
        "C:/Users/USERNAME/AppData/Roaming/npm/node_modules/mcp-package-version/build/index.js"
11
      ]
12
    }
13
  }
14
}

node版本需要v16以上，执行上述npm命令安装进全局，最终包的路径为

1
C:/Users/USERNAME/AppData/Roaming/npm/node\_modules/mcp-package-version

打开cursor，进入设置，如上图所示，先点”1”，进入MCP配置。然后点”2”，添加一个MCP服务。

如果没有设置过，会在C:/Users/USERNAME/.cursor目录下生成一个mcp.json的文件，将上面json复制进去(记得改一下USERNAME为自己实际电脑的路径)。

图中”3”点一下，使其显示”Enabled”。这时点”5”的位置，就会启动本地MCP服务，此时电脑会弹出一个node的窗口，一定不要关闭，留着它。

如果需要修改配置，可以点”4”的位置，进入JSON编辑。

如果上述操作都完成，可以看到”6”的位置”mcp-package-version”前面有一个绿色的小圆点。如果这个小圆点是空心的，需要再点一下”3”位置的”Disabled”。如果这个小圆点是红色的，说明服务还没有起来，需要再点一下”5”位置的图标。

如果正常，那么”7”位置，tools会列出所有可用的工具。反之，没有显示东西，就是没成功。请检查设置，特别是”command”和”args”，是否正确。

测试一下是否工作正常。

图片

切换到Agent模式，然后输入问答。得到本地电脑正确的信息，如上图所示。

总结

今天学习了基本的MCP的概念，并动手成功跑了一个例子。理解最简单的MCP服务如何操作，使其能被大模型使用。但是，还有更多的MCP的概念没有引入，后面的文章将继续探讨，敬请期待。

Dify应用实战(18) - 发布成MCP服务

2025-07-23T12:32:13.000Z

今天我们将要继续企业应用之旅，让Dify自己也变成为MCP服务，成为助手类工具或者现有系统的定制化AI工具服务。

学习完成，你将能让自己的桌面助手工具，集成最近一段时间辛苦创建的Dify应用。这样就可以暂时不去Dify的控制台去使用工作流了。

01.准备环节#

在我们开始之前，有需要安装一个工具。感谢伟大的开源作者们的奉献，这个世界因你们而精彩。

去插件->marketplace，搜一下SSE，看到下图这个插件，就安装一下。

图片

至此，所有今天需要的准备就完成了，恭喜！

02.动手做一做#

找到之前实战的案例：“图片生成”，简单裁剪一下。然后去发布那里，发布为工具。

图片

按照下图所示，输入一个工具调用名称，并且描述写好，最好详细一点，能让大模型理解这个工具到底是干啥的。

图片

此时在Dif有点工作流里，应该就出现这个应用了。

接着开始配置新安装的插件。

进入插件，找到它”MCP Compatible Dify Tools”，点击之后，会出现在页面右边。这时继续点击”API端点”右侧的加号。

图片

就会进入端点配置页。填入端点名称，可以随意输入。然后点击”工具列表”右侧的加号。在弹出”添加工具”的配置项里，按照下图顺序，依次切换到”工作流”，选中前面发布的工具的那个工作流。

图片

这时基本上就配置完成了，点击”保存”。

图片

看到下图界面，就说明这个工具就已经开始工作了。点击GET那一行后面的复制按钮，将URL复制出来，留着备用。

图片

03.应用和测试#

经过上面的操作，Dify就已经化身为一个SSE的MCP服务了。那么最后一步就是验证这个工具是否真正的可用。

这次我们依然选择开源的DeepChat工具。先去配置一下MCP。添加服务器的页面先点”跳过至手工配置”，然后输入服务器名，可以随便输入，如”dify”，然后服务器类型，下拉选择服务器发送事件SSE模式，基础URL填入，上面留着备用的那个地址。但是需要把localhost改为Dify服务器的服务IP。如下图所示

图片

提交之后，切换到chat界面，点击小锤子，可以看到刚刚配置的工具是可用状态了。

图片

终于，来到了激动人心的环节。对话框输入”虹口区天气怎么样？“，一切都会按照预期的那样，大模型去找了一圈工具，发现有一个天气预报服务的工具，然后把控制权交给了Dify的工作流，工作流开始按照开发AI应用的步骤执行，最后输出了结果。然后本地工具DeepChat也拿到了最后的结果，并展示了调用过程中使用工具的情况。

图片

总结

今天学习了将Dify系统开发的AI应用变成可供其他工具或者系统调用的MCP服务，从而打通了系统之间的壁垒。你的Dify应用将会直接为你的助手类工具使用，或者集成到现有应用中，能扩展其AI能力。

终于MCP相关的话题可以告一段落了。从MCP是什么，到怎么开发，然后是怎么使用MCP，最后是自己化为MCP。期望读者能顺着麦金叔的脉络，真正的把这些学会，并融会贯通投入到自己的项目中。

Dify应用实战(7) - 图片生成(下)

2025-07-23T12:32:13.000Z

01.环境准备#

大家通过昨天的教程，已经知道如何生成图片，并看到了最终效果。但是为什么要按照这样的流程进行编写，还是知其然，不知其所以然。
那今天麦金叔就给大家还原一下真相。
因为前面也提到了，这次的动手依赖两个第三方的服务工具。因此，如果想自己动手的，先把账号注册好吧。

图片

注册成功后直接来到了控制台页面，此时按图创建应用。

图片

继续点击新创建的一串数字APPID的应用，打开”应用详情”。可以看到现在API密钥这里是空的，点击右方”新增密钥”，获得一条记录。页面显示一长串数字字母的字符串，右边有个复制按钮，点一下复制保存到安全的地方，留着备用。
再说一下，这个服务宣称是免费，但实际上是每个账号每月有1000次的免费处理次数，正常使用基本上算免费了。但如果你的业务需求量很大，可以购买资源包，也不贵，一张图5厘，已经蛮良心的了。

图片

按图所示注册figma，这个是美丽国的服务工具，虽然有一些不好的名声，但是在设计SaaS服务领域还是发展很快的。我们用它纯属”白嫖”，不用有太多顾虑。

图片

1
注册后，下载一个包装的桌面版。然后记住这个插件，等下就要用，Batch auto-generate images using your design

(https://www.figma.com/community/plugin/1273461051550664878)

图片

1
工具和插件都准备好之后，我们就继续回到Dify里面。

02.流程拆解#

图片模板请求体构造#

昨天只说了需要构建一个图片模板的请求体JSON。但这个JSON为何是这样构建的呢？如果靠手写那肯定是不现实的，好在方法也很简单。
我们先在figma里做一个图片的布局，如示例里面，有一个背景图，再有一段文案（为了教学，尽量简单处理了，实际应用时，只是元素对象多一点而已）。先新建一个”Design file”

图片

在空白画布上添加一个Section，注意将Dimensions的W和H（即图片的宽和高）设置为你最终生成的图片的分辨率大小。并将Posion的X和Y都设置为0，即左上角对齐原点。
好了，图片第一层为背景层，准备好一张与图片大小一致的底图，通过工具栏的Image进行插入。Position也设置为0，这样就对齐了。

图片

在背景图上添加”TEXT”，并将其拖拽到画布合适的位置，注意文本的Posion位置，和长宽值，是否合适。可以事先添加与文案长度差不多的文字内容，来观察是否能一行显示，还是要多行。一定要确保最终生成时不要超出背景图片的区域。

图片

本文的示例就这两个元素，实际工作，需要酌情修改设计。这一步如果有设计师朋友帮忙，那就小菜一碟了。
有了设计稿，现在利用上面让准备的插件，就能将设计转化成JSON。选中整个设计，左上角的菜单，转到Plugins菜单项，点击”imgrender - Batch auto-generate”。便会打开一个小对话框，点”Output”按钮。如果提示”Successful!”字样，就说明好了。
这时，需要打开一个文本编辑软件，按Ctrl V就可看到全部内容。如果过程中有问题，看提示解决。大概是导出只能是一层，如果设计放在多层，是不能全部导出的。

1
{
2
  "width": 420,
3
  "height": 600,
4
  "backgroundColor": "#ffffff",
5
  "images": [
6
    {
7
      "x": 0,
8
      "y": 0,
9
      "width": 420,
10
      "height": 600,
11
      "url": "背景图URL",
12
      "zIndex": 1
13
    }
14
  ],
15
  "texts": [
16
    {
17
      "x": 60,
18
      "y": 60,
19
      "text": "文案文案文案文案文案",
20
      "width": 240,
21
      "font": "SourceHanSansSC-Normal",
22
      "fontSize": 16,
23
      "textAlign": "left",
24
      "zIndex": 4,
25
      "color": "#000000"
26
    }
27
  ]
28
}

展开收起

有了这个设计模板JSON，现在就可以去Dify的模板节点去拼接了。
拆分成几个部分就行了，记得images里面的url改为一个imgrender服务能访问到的公网背景图片路径。
texts里面的元素，text部分，用Jinja模板语法，将前序节点的输出string替换为上述JSON里面的”文案文案文案文案文案”。

HTTP请求构造#

再坚持一下，马上就要成功了。
“HTTP请求”按上篇中的截图设置。
API方法选择POST，地址为imgrender的服务地址：https://api.imgrender.net/open/v1/pics ，添加鉴权API-key，改为自定义，Header项填入X-API-Key，key就粘贴前面新建应用时得到的新增密钥。
保存后，继续设置HTTP请求。 HEADERS增加key为Content-Type，value为application/json; charset=utf-8
BODY，选择raw，值框中输入/ 后选择合并完的output

图片

如果有使用HTTP服务的经验，这一点非常容易做。

获取结果图片#

这个”代码执行”节点，继续使用Python，代码非常简单，就是从imgrender的API请求结果中，获得图片URL。
好了，今天的内容终于结束了。其中最繁琐的是图片模板的处理。全程无尿点，累并快乐着。

总结#

今天在对有预期效果的工作流上，详细解释了其中节点的设计思路，并完整详细的讲解了操作过程最后利用图片生成服务得到了我们期望的带背景和文案的结果图片。还是昨天麦金叔说的，最终成品效果如何，就依赖设计能力了。

Dify应用实战番外 - 网友提问(2)

2025-07-23T12:32:13.000Z

01.动手做一做#

随便创建一个工作流。添加”代码执行”和”结束”。

并填入代码如下：

图片

保存后进行测试。结果如下图：

图片

1
提示非常清楚，就是找不到依赖库pandas。
2

3
那我们就把库安装上，因为运行时是由sandbox提供的，所以我们找到docker-compose.yaml中sandbox的定义。其中有个卷的映射，
4

5
./volumes/sandbox/dependencies:/dependencies
6

7
这里就是我们添加依赖的地方。工程目录下docker/volumes/sandbox/dependencies下有一个空文件python-requirements.txt
8

9
输入一行"pandas==2.2.3"

重启docker服务，查看docker-sandbox-1的日志，会看到在启动sandbox时，会安装第三方库。

图片

重新运行”工作流”(如果还报错找不到pandas，需要等待一会儿，安装有可能还没有完成，一定要看到sandbox的log里面显示python dependencies installed)。发现已经不再报错找不到pandas，而是提示另外一个错误。

图片

绝望了呀，赶紧问问DeepSeek和豆包是咋回事啊。

好的，它们都说是沙盒环境的权限限制导致的，但好歹也要给出如何修改的建议吧？对不起，没有，请自行解决。

这下难题还是留给了麦金叔，只能硬着头皮上了。

02.解决沙盒权限#

通过官方dify-sandbox开源项目的FAQ，知道由于怕沙盒权限太大，导致不可控风险，所以本着最小化开放权限的原则，缺省的权限就很小。

知道问题的根结，那应该就很好解决了。

方案一

和刚才添加依赖一样，工程目录下docker/volumes/sandbox/conf里面有一个config.yaml文件，找到allowed_syscalls段，把需要的权限加进去。

重新启动服务之后，测试就通过了。

图片

方案二

1
修改源代码，/internal/static/python\_syscall/syscalls\_amd64.go
2

3
把所需要的权限都添加进去，这里是以syscall开头的枚举值。如果出现所需要的权限没有定义，也不要紧，直接写数值也可以的。

改完了之后，需要重新编译dify-sandbox镜像。并将自己编译的镜像tag，替换进docker-compose.yaml。

重新启动服务后，也可以运行。

这个方法适用于所有没有权限执行的第三方库。

不过Dify的”代码执行”最好不要有太过复杂的脚本执行，一个是难以调试，另一个也是容易执行超时。

如果很依赖Python执行，可以按照”插件”的方案。将其封装为一个插件，每个插件也可以定义自己的requirements。这样也就不用怕没有权限了。

总结

今天的答疑来自网友的留言问题，当然有可能他说的Python脚本不能执行的问题，还不是这篇文章介绍的。请务必要理解，Dify的Python执行环境是独立的，和本机的Python环境没有关系，哪怕就是本机运行的容器环境。

Dify应用实战(8) - 对话记忆

2025-07-23T12:32:13.000Z

今天我们开启一个新的项目 — 智能医疗分诊助手。
学习完成，你将掌握如何构建多轮对话应用，获得更为准确的信息，以实现特定的任务。

01.动手做一做#

暂时先将之前的案例放一放，大家需要新建一个对话流。放心，之前的图文生成和语音项目还未最终完成，但已经变得有点复杂了。如果是刚开始学的同学，可能有点跟不上。所以，我们为了降低难度，先再开启一个新项目，把没学的内容补齐。

最后会做完完整版的工作流。麦金叔先卖个关子，记得点赞、关注、收藏不迷路。

今天我们来动手做一做智能医疗分诊助手”医小智”的开发。

还是老规矩，这次我们选新建空白应用，类型用”Chatflow”。这其实和Workflow是差不多的，只是有一点差异，Chatflow是基于对话的，并且内置了记忆能力，即能将多轮对话的历史记忆保存并传递给下一轮对话。

图片

新创建完成，自动会添加三个节点：“开始”，“LLM”和”直接回复”。

图片

此时，就已经可以点击”预览”，进行对话调试了。

图片

好了，准备工作就绪，我们正式开始项目开发。

“医小智”是一台放在医院大门口的机器人，它将代替问诊台的服务人员，初步判断来医院就诊的客人，属于什么病因，引导客人去相应的科室挂号就诊。

首先，需要在客人说之前，要有欢迎和引导语。点击右上”功能”，开启”对话开场白”。这里输入的是“您好，我是您的问诊小助理，医小智。请问您哪里不舒服呢？”

图片

接着，需要对”LLM”节点做深入的设置。

在”上下文”这里设置变量值，选择”开始”的用户输入sys.query。这里注意一下，Chatflow内置了很多输入参数，可以直接用，不像工作流，输入的参数需要自己定义。

在SYSTEM提示词这里，通过输入/符号，将上下文代入。

图片

因为Chatflow内置了”记忆”，就不需要手动选择能力。并在下面记忆这里打开它，设置合适的窗口大小。

图片

完成之后，点击”发布”进行保存，就可以进行测试了。

点击”发布”按钮后，选择”运行”。会开启一个新的页面，点”Start Chat”，即开启对话。

图片

得到机器人的欢迎词后，我们输入第一轮的对话。

图片

可以继续对话。

图片

但是如果用户对话输入不相干内容，看智能客服如何应对？

图片

今天的动手做就完成了。下面讲解一下里面关键的知识点。

02.补充说明#

今天的应用非常简单，但是效果却非常棒。有同学会很好奇，这也太神奇了吧，都不需要用Function Call或者RAG就能为指定的医院提供个性化的门诊导流服务。

那为什么仅仅是用Prompt提示词，就可以完成呢？这里就不得不介绍一下大语言模型的基础能力知识，Transformer架构了。

而Transformer模型是基于自注意力机制的深度学习模型。能让AI理解你的提问，并回答准确，就需要计算机模仿人类的行为。

在你阅读一本书的时候，当读到某个句子，你的大脑会自动关注句子中的关键词，并将这些关键词与前面提到的信息联系起来，从而理解整个句子的含义。自注意力机制就是模仿这种人类阅读理解过程的一种算法。

简单来说，自注意力机制允许模型在处理序列数据（如句子）时，自动找出序列中各个元素之间的关联。它能够让模型在处理某个位置的信息时，同时考虑到整个序列中的其他相关信息，而不仅仅是附近的信息。

自注意力机制是一种强大的序列建模技术，它通过计算元素之间的相似度，让模型能够聚焦于重要的信息，并忽略无关的噪声。这种机制在自然语言处理、计算机视觉、语音处理等领域都有着广泛的应用和显著效果。

它为序列数据的处理提供了新的思路和方法，使得模型能够更好地理解和利用序列中的信息，从而推动人工智能技术的进步和发展。

原理讲解比较无趣，如果不感兴趣可以忽略。

总结

今天又开启了一种新应用类型 — “Chatflow”的学习。它封装了和对话相关的能力。但它本质上依然是一种workflow，之前学的那些技能，也都能放进去。

通过”医小智”的实战，让你可以做出最简单的客服对话类智能体，后续会结合Dify的能力，补充进更为复杂的功能，让真正的变成一个能落地的AI应用。

Dify应用实战(11) - 条件分支

2025-07-23T12:32:13.000Z

本文适用对象：初级水平

目标：对一个结果可能出现多种情况，进行条件分支处理

上一节Dify应用实战课，我们学习了迭代循环处理。而新项目，智能医疗分诊助手，暂停了一期，现在我们继续。

今天我们学习和上节课循环处理类似的方法，分支条件处理。

学习完成，你将掌握如何对一个结果可能存在多种情况时，按不同情况的值，进行不同的处理。

01.动手做一做#

今天的任务基于智能分诊应用”医小助”。在”问题分类器”的”分类2”后新增一个”LLM”节点。

图片

如图所示，添加提示词内容“对

提及的有关视力的部分，进一步进行识别处理，处理结果输出为如下json格式，

1
{ "type": 0, "result":"","raw":""}
2

3
如果是咨询近视有关的，将type设置为1；
4

5
如果是咨询眼睛疾病，将type设置为2；
6

7
对输入的问题的解释结果，设置为result的值。”

这次我们把大模型的输出格式修改一下，如下图

图片

接着添加”代码”节点，将上一步生成的JSON结果，提取问题类别type，注意输入和输出的变量和类型

图片

现在我们就可以根据问题类型，来进入不同分支了。添加新节点”条件分支”。

图片

这样根据所匹配的结果，才能有不同的分支来承接。因此这里为了简化，直接都添加”回复”，来测试流程是否正确。

图片

保存之后，我们进行测试，如下：

图片

可以看到，我们的对话，走到了正确的分支。

希望今天的动手分支，也能跟着麦金叔做下来。

02.补充说明#

今天学的条件分支，与上次的迭代，都是编程思想里面最重要的基础概念。

大家一定要能掌握，才能在今后的AI应用开发中，游刃有余的处理复杂的场景。

正如之前课程麦金叔一直强调的：打败你的不是AI，而是会用AI的人。麦金叔希望，你花点时间，动手练一练，成为那个打败别人的人。

总结#

今天学习一个重要的新的组件”条件分支”。有了它在AI应用开发的”拖线条”过程中，才能真正应对复杂场景。它比问题分类器还要简单，都不需要利用大模型的能力，就能做好分类处理。

Dify应用实战(16) - 数据可视化

2025-07-23T12:32:13.000Z

今天我们将要继续企业应用之旅，让Dify也变成一个简单的BI系统，可以让数据变成有图有真相。

学习完成，你将能举一反三，让数据自己说话。

01.动手做一做#

今天的动手实验，需要有处理数据的代码能力。如果对你来说难度太大，建议收藏慢慢学习。

首先，我们简化核心步骤，把不相干的节点全部删除。掌握了之后，可以集成进前面课程有关数据SQL的部分

既然是和数据相关，那准备的部分必然涉及到数据库。假设我们有一个数据表名为automation，记录了企业中，对订单进行自动化处理的情况。

图片

该表设计的思路是，针对每个订单，都会进行自动化处理，并记录处理结果。并且按业务规则，运行失败时会进行一定次数的重试，以避免因资源等环境问题导致的暂时失败，而影响可以自动化的任务。

记录自动化处理的结果字段为code，0表示不符合自动化处理条件，1表示自动化处理成功，大于1的值表示自动化程序内部的错误。

我们需要按照订单的日期来查询按天统计的订单处理情况。查询语句和结果如下图所示。

图片

有了上述准备之后，开始进行Dify应用开发。

添加”SQL Execute”节点(如果没有，需要安装插件后，进入工具选择，见之前的博文)，修改设置为：

SQL查询语句：同sql query语句
输出格式：选Constant，JSON

图片

新增”代码执行”节点，输入变量选上一个”SQL Execute”的json，代码内容需要对SQL查询工具输出的JSON数据进行转换，然后将变形后的数据，按照echarts的模版进行输出。

图片

最后”回复”节点的输入就选择”代码执行”的结果。

图片

保存之后，进行测试。因为这个简化流程没有”LLM”节点，也不依赖输入，所以可以直接执行，其结果如下：

图片

02.补充说明#

为了聚焦数据可视化的处理方法，这个流程做了最大程度的简化。所以实际生产过程中，需要理解其中的方法，进行改写变形。

1. 示例数据查询语句是写死的。

改进点：利用文生SQL，让大语言模型生成合适的SQL，并开放查询时间范围参数。比如查询一周内，或者一个月内的数据。

2.echarts图表是写死的。

改进点：可以预先定义echarts的图表样式，如折线图，或者柱状图，饼图等，以适配不同的业务需求。

希望各位网友能发挥主观能动性，进行更贴合业务需要的开发。当然，越是复杂的可视化，对开发和使用echarts的能力要求也越高。

总结

今天学习了将数据进行可视化生成，让AI有了图表的展示能力，更贴合企业用户的使用需求。因为示例代码较长，截图不便，想参考学习的朋友，扫描下方小助手的微信号，发送”可视化”，以获得DSL文件。

设置 WSL 开机启动并在后台运行

2025-06-23T12:32:13.000Z

后台运行#

在命令行下使用 wsl -l -v 得到想要启动的 WSL 版本，比如我的机器上是 Ubuntu-24.04，后面命令中使用 Ubuntu-24.04 来代表目标 WSL 版本。

Terminal window

1
Administrator in ~ λ wsl -l -v
2
  NAME            STATE           VERSION
3
* Ubuntu-24.04    Running         2

新建一个 wsl-d.vbs 文件（文件命名随意）作为启动脚本，里面内容如下：

Terminal window

1
set ws=wscript.CreateObject("wscript.shell")
2
ws.run "wsl -d Ubuntu-24.04", 0

后续启动 WSL 时直接运行这个启动脚本就会让 WSL 在后台运行了。

退出#

退出还是正常的就可以了：

Terminal window

1
# 直接退出默认 wsl
2
wsl --shutdown
3

4
# 指定 wsl 退出
5
wsl -t Ubuntu-24.04

开机启动#

如果想要在 windows 启动时就直接后台运行 WSL。

快捷键 WIN + R 运行，输入 shell:startup 打开启动目录后，把上面哪个 wsl-d.vbs 脚本文件复制进去就就可以了。

网页克隆神器出世！一键11复制任何网站，前端开发效率翻倍--Same.New

2025-03-23T12:32:13.000Z

有没有想过，当你看到一个设计感极强的网页，能直接「借」来它的界面和代码，自己还能随便修改？现在，Same.new 让你真的可以——完全免费，接近 1<1> 地克隆任何网站，包括视觉效果和前端代码。

Same.new 是一款基于神经网络的智能网页复制工具。你只需要输入目标网址，它就能自动解析出包括布局（Header、Footer、侧边栏等）、UI 组件（按钮、表单、图片、导航栏等）、样式（CSS + 响应式规则）甚至交互逻辑（HTML 结构、JS 行为）在内的所有内容。生成的结果会直接呈现在内置编辑器中，你可随时查看、编辑、导出，或进行二次开发。

图片

它的还原度极高，同一页面几乎看不出差别。无论是博客、电商首页还是企业官网，Same.new 都能精准捕捉原有布局与交互逻辑，真正做到「所见即所得」。

比方说你想复刻某个漂亮的登录页或产品详情页，操作就三步：

🟢 输入网址；
🟢 点击“Clone”；
🟢 直接拿到 HTML + CSS + JS 打包代码。

之后你就可以在本地跑起来，甚至当成项目起点模板继续开发。

✨ 主要功能：

🆓 完全免费，无页面数量或次数限制；
🔁 接近 1<1> 还原，不只是截图，而是真实代码；
💻 一键导出干净的前端文件；
👀 实时预览，编辑即所得；
✍️ 支持在线调整样式与结构。

📦 使用流程超简单：

访问 same.new；
输入你想克隆的页面URL（推荐公开非验证型页面）；
点击执行，等待几秒；
查看、编辑、下载——搞定。

🛠 推荐使用人群：

前端开发：快速提取页面结构或组件参考；
UI/UX 设计师：分析竞品界面，获取排版与交互灵感；
自学党/学生：通过真实页面学前端布局与代码写法；
创业小团队：极速搭建 Landing Page 或产品原型；
测试同学：复制线上页面用于UI比对或自动化测试。

⚠️ 使用注意：

✅ 允许用于学习、研究、原型测试等场景；
❌ 严禁直接商用或复制受版权保护的完整页面；
✅ 建议在合理使用原则下借鉴样式或结构。

请尊重原创和知识产权，合法使用工具。

📌 总结一下： Same.new 几乎把网站克隆变成了“复制粘贴”的活儿。不管你是为了开发提速、学习代码，还是快速实现界面灵感，它都算得上是一把顺手利器。无需注册、不花钱，界面+代码，一气呵成。

想“扒”个页面看看人家怎么写的？想做页面原型却不想从头画？试试 Same.new，你可能会发现：原来写页面，还能这么轻松。

不想修改hosts？这个神器更简单！SteamTools 让你一键加速GitHub和Steam，告别网络问题

2025-03-23T12:32:13.000Z

朋友们！不想修改hosts的看过来！#

昨天我给大家推荐了 fetch-github-hosts 来解决 GitHub 访问慢的问题，但是有小伙伴反馈说：“修改 hosts 文件太麻烦了，而且担心搞坏网络设置”。

今天我要给大家介绍一个更简单的解决方案——SteamTools（瓦特工具箱），它不仅能加速 GitHub，还能加速 Steam，而且不需要修改 hosts 文件，一键就能搞定！

什么是 SteamTools？#

SteamTools（瓦特工具箱）是一个开源跨平台的多功能 Steam 工具箱，它不仅可以加速 Steam，还能加速 GitHub 等网站，而且不需要修改 hosts 文件，使用起来非常简单。

为什么推荐 SteamTools？#

1️⃣ 不需要修改 hosts 文件#

这是最关键的一点！SteamTools 采用本地反代的方式来加速网络，不需要修改系统的 hosts 文件，避免了可能导致的网络问题。

2️⃣ 功能强大#

SteamTools 不仅仅是一个加速工具，它还有很多其他实用功能（当然今天就只介绍加速 GitHub 的功能）：

网络加速：加速 Steam、GitHub 等网站的访问速度
账号切换：快速切换多平台账号
库存游戏：管理 Steam 游戏库存，编辑游戏名称和封面
本地令牌：在电脑中保存手机令牌，支持多种令牌导入
自动挂卡：挂机掉落 Steam 集换式卡牌
游戏工具：强制游戏窗口使用无边框窗口化等

3️⃣ 跨平台支持#

SteamTools 支持多种操作系统：

Windows 10/11
macOS 10.15 或更高版本
Linux（Ubuntu、Debian、Fedora、Deepin等）

4️⃣ 开源免费#

SteamTools 是开源项目，完全免费使用，没有任何广告。

如何使用 SteamTools 加速 GitHub？#

步骤1：下载并安装 SteamTools#

首先，你需要下载并安装 SteamTools(https://steampp.net/)。

步骤2：打开 SteamTools#

安装完成后，打开 SteamTools 应用。

步骤3：启动网络加速#

在 SteamTools 主界面，点击”网络加速”选项
在网络加速设置中，找到”GitHub”相关的加速选项
点击”启动加速”按钮
等待加速服务启动完成

步骤4：测试 GitHub 访问速度#

启动加速后，打开浏览器访问 GitHub，你会发现访问速度明显提升！

常见问题#

Q: 我们开启 GitHub 加速后，网页是加速了，但 git 命令还不行,克隆不了代码怎么办？ A: 如果想让 git clone 等命令也实现加速的话，我们还需要配置一下 git 的代理。

首先将 Watt Toolkit 的 GitHub 加速模式 选择 系统代理模式 然后我们可以通过操作系统的 设置 -> 网络和 Internet -> 代理 来查看代理 IP 和端口，例如：127.0.0.1<26561>。然后，我们打开终端，通过以下命令来设置 git 的 HTTP 代理，并且还要同时禁用 SSL 证书检查，这样 git clone 等命令也会实现加速效果了。

Terminal window

1
git config --global http.proxy 127.0.0.1:26561
2
git config --global http.sslverify false

取消 git 代理的方式如下：

Terminal window

1
git config --global --unset http.proxy
2
git config --global --unset http.sslverify

Q: 开机后连不上网络怎么办？ A: 打开 SteamTools 应用，点击”网络加速”选项，找到”GitHub”相关的加速选项，点击”一键加速”按钮，再点击”退出加速”按钮即可。

Q: 我已经关闭加速了，但git clone 不了gitee/gitlab 项目怎么办？ A: 执行上面的取消 git 代理命令即可。

我的使用体验#

前几天我使用了 SteamTools 加速 GitHub，效果真的非常好：

不需要修改 hosts 文件，一键启动加速
GitHub 访问速度从之前的 10 多秒加载时间减少到 1-2 秒
Steam 商店和社区的访问速度也明显提升
账号切换功能非常方便，不用重复登录不同账号
本地令牌功能让我不再需要频繁查看手机上的令牌

适合谁用？#

不想修改 hosts 文件的用户：担心修改 hosts 文件会导致网络问题
Steam 玩家：需要加速 Steam 商店、社区和游戏下载
GitHub 用户：需要快速访问 GitHub 查看代码、克隆项目
多平台游戏玩家：需要在多个游戏平台之间切换账号
任何人：需要一个多功能的游戏工具箱

注意事项#

关机前一定要先退出加速：如果忘记退出加速，再次开机时，可能会导致网络连接不上的问题，这个时候不要慌，重新启动 SteamTools 即可。

项目地址#

如果你对 SteamTools 感兴趣，可以访问它的 GitHub 仓库：https://github.com/BeyondDimension/SteamTools

互动时间#

你们平时是如何解决 GitHub 和 Steam 访问慢的问题？使用 SteamTools 后有什么感受？欢迎在评论区分享你的故事！

如果你在使用过程中遇到了什么问题，也可以在评论区留言，我会尽力回答！

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

免费！免服务器！前端新手也能用的部署神器 —— PinMe

2025-03-23T12:32:13.000Z

PinMe 是什么？#

PinMe 是一个开源命令行工具，可以帮你一键部署网页。

不需要服务器
不需要域名
不需要注册账号

只需要两行命令：

Terminal window

1
npm install -g pinme
2
pinme upload

几秒后，你就能获得一个专属链接。

这就是你的网站 —— 随时访问，不限速，不会下线。

PinMe适合谁用？#

PinMe 适合所有想快速上线页面的人：

前端学习者 / 学生党：做完项目，马上分享成果
设计师 / 内容创作者：轻松发布个人主页、作品集
自由职业者 / 小团队：省时省力，快速搭建简单站点
独立开发者：追求简单稳定、不被限流的上线方式

PinMe 会自动帮你搞定部署，

你只需专注于“写完页面，直接上线”。

相比传统服务，PinMe 能为你带来什么？#

图片

总结一句话：

PinMe = 免费GitHub Pages + Netlify + 永久 ENS 域名版！

给每个想快速上线的前端人

你可能刚学完 Vue / React，做了第一个作品；

你可能是自由职业者，想展示自己的介绍页；

你可能只是想有一个属于自己的网页空间。

别再被部署拦住，从 PinMe 开始，一行命令，永久免费上线。

快速开始#

📌PinMe 官网：

https://pinme.eth.limo/

📌戳这里收藏项目：

https://github.com/glitternetwork/pinme

⭐别忘了去GitHub 点个Star! 支持每一个为开发者省事的开源项目！

Nginx性能优化全方案：打造一个高效服务器

2025-02-23T12:32:13.000Z

图片

一、调整工作进程数和线程数#

Nginx采用异步非阻塞的方式处理请求，这种方式可以充分利用CPU资源，提高并发处理能力。但是，过多的工作进程和线程会导致系统资源浪费，降低性能。因此，需要根据实际情况调整Nginx的工作进程数和线程数。

unsetunset调整工作进程数unsetunset#

Nginx的工作进程数是指Nginx启动后生成的子进程数量。可以通过修改Nginx配置文件中的worker_processes参数来调整工作进程数。

例如：

1
worker_processes 4;

表示将Nginx的工作进程数设置为4。

unsetunset调整线程数unsetunset#

每个工作进程都有一个默认的线程数，即Nginx的事件处理模型中包含的线程数。可以通过修改Nginx配置文件中的worker_connections参数来调整线程数。

例如：

1
worker_connections 1024;

表示将每个工作进程的线程数设置为1024。

需要注意的是，线程数并不是越大越好，因为线程之间的竞争可能会导致性能下降。因此，需要根据实际情况进行调整。

二、启用Gzip压缩#

Gzip压缩是一种常用的网页压缩技术，可以减少传输的数据量，提高页面加载速度。Nginx支持Gzip压缩功能，可以通过配置Nginx来实现。

unsetunset安装Gzip模块unsetunset#

首先需要在编译Nginx时安装Gzip模块。在Linux系统中，可以使用以下命令安装：

1
./configure --with-http_gzip_static_module --with-http_gzip_module
2
make && make install

unsetunset配置Gzip压缩unsetunset#

在Nginx配置文件中添加以下内容：

1
http {
2
    ...
3
    gzip on; # 开启Gzip压缩功能
4
    gzip_min_length 1k; # 设置最小压缩文件大小为1KB
5
    gzip_buffers 4 16k; # 设置压缩缓冲区个数和大小
6
    gzip_http_version 1.1; # 设置支持的HTTP协议版本为1.1
7
    gzip_comp_level 2; # 设置压缩级别为2（速度与压缩率的平衡）
8
    gzip_types text/plain application/x-javascript text/css application/xml; # 设置需要压缩的文件类型
9
    ...
10
}

三、配置缓存策略#

缓存是提高网站性能的重要手段之一。Nginx提供了多种缓存策略，可以根据实际需求进行配置。以下是一些常见的缓存策略：

unsetunset配置浏览器缓存时间unsetunset#

通过设置HTTP响应头中的Expires和Cache-Control字段，可以控制浏览器缓存的时间。

例如：

1
location ~* \.(jpg|jpeg|gif|png|css|js)$ {
2
    add_header Cache-Control "public, max-age=31536000"; # 设置静态资源的缓存时间为1年（单位：秒）
3
}

unsetunset配置代理服务器缓存时间unsetunset#

如果Nginx作为反向代理服务器使用，可以通过设置proxy_cache_valid和proxy_cache_valid指令来控制代理服务器的缓存时间。

例如：

1
location / {
2
    proxy_pass http://backend; # 将请求转发到后端服务器
3
    proxy_cache mycache; # 启用缓存，命名为mycache
4
    proxy_cache_valid 200 302 60m; # 设置缓存有效时间为60分钟（单位：秒）
5
    proxy_cache_valid 404 1m; # 设置缓存有效时间为1分钟（单位：秒）
6
}

四、优化文件访问方式#

在处理静态文件时，Nginx默认会将文件读取到内存中进行处理。这种方式在大文件或高并发情况下会导致内存消耗过大，影响性能。因此，可以采用优化文件访问方式来提高性能。以下是一些优化方法：

unsetunset使用sendfile()函数发送文件数据unsetunset#

sendfile()函数可以直接将文件从磁盘读取并发送到网络，避免了数据在用户空间和内核空间之间的拷贝，提高了性能。可以通过在Nginx配置文件中添加以下内容来启用sendfile()函数：

1
http {
2
    ...
3
    sendfile on; # 开启sendfile()函数支持功能（需要操作系统支持）
4
    ...
5
}

unsetunset启用sendfile_max_chunk和tcp_nopush参数unsetunset#

通过设置sendfile_max_chunk和tcp_nopush参数，可以控制Nginx在发送文件时的最大分片大小和TCP_CORK选项。

例如：

1
http {
2
    ...
3
    sendfile_max_chunk 1m; # 设置最大分片大小为1MB
4
    tcp_nopush on; # 开启TCP_CORK选项
5
    ...
6
}

五、优化日志配置#

日志是排查问题的重要手段，但是过多的日志会导致磁盘空间不足，影响系统性能。因此，需要对Nginx的日志进行优化。以下是一些优化方法：

unsetunset调整日志级别unsetunset#

Nginx支持多种日志级别，如debug、info、notice、warn、error等。可以通过修改Nginx配置文件中的log_level参数来调整日志级别。

例如：

1
http {
2
    ...
3
    log_level info; # 将日志级别设置为info
4
    ...
5
}

unsetunset配置日志切割和压缩unsetunset#

为了减少日志占用的磁盘空间，可以配置日志切割和压缩功能。例如：

1
http {
2
    ...
3
    access_log /var/log/nginx/access.log combined buffer=32k flush=1m; # 配置访问日志切割和压缩功能
4
    error_log /var/log/nginx/error.log info; # 配置错误日志，并设置日志级别为info
5
    ...
6
}

六、其他优化建议#

除了上述优化方法外，还有一些其他的优化建议：

unsetunset使用CDN加速静态资源访问unsetunset#

CDN（Content Delivery Network）是一种内容分发网络

可以将静态资源缓存到离用户更近的节点上，提高访问速度。
可以使用阿里云、腾讯云等云服务商提供的CDN服务。

unsetunset使用HTTP/2协议提高传输效率unsetunset#

HTTP/2协议是一种新的HTTP协议，支持多路复用、头部压缩等功能，可以提高传输效率。需要在Nginx和客户端同时支持HTTP/2协议才能生效。可以通过修改Nginx配置文件中的listen指令来启用HTTP/2协议。例如：

1
server {
2
    listen 443 ssl http2; # 启用HTTPS并启用HTTP/2协议支持功能（需要操作系统和SSL库支持）
3
    ...
4
}

音乐馆页配置

2025-01-23T12:32:13.000Z

音乐馆页配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page music

你会找到 source/music/index.md 这个文件
修改这个文件：记得添加 type: "music"

1
---
2
title: 音乐馆
3
date: 2021-04-24 21:41:30
4
type: music
5
aplayer: true
6
top_img: false
7
comments: false
8
aside: false
9
---

新建 source/json/music.json，此 json 为切换歌单按钮的歌单数据。

1
[
2
{
3
"name": "青花瓷",
4
"artist": "周杰伦",
5
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.4/青花瓷/青花瓷.mp3",
6
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002eFUFm2XYZ7z_2.jpg?max_age=2592000",
7
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.4/青花瓷/青花瓷.lrc"
8
},
9
{
10
"name": "稻香",
11
"artist": "周杰伦",
12
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.1/周杰伦/稻香/稻香.mp3",
13
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002Neh8l0uciQZ_1.jpg?max_age=2592000",
14
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.1/周杰伦/稻香/稻香.lrc"
15
},
16
{
17
"name": "晴天",
18
"artist": "周杰伦",
19
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/晴天/晴天.mp3",
20
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000000MkMni19ClKG_3.jpg?max_age=2592000",
21
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/晴天/晴天.lrc"
22
},
23
{
24
"name": "七里香",
25
"artist": "周杰伦",
26
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/七里香/七里香.mp3",
27
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000003DFRzD192KKD_1.jpg?max_age=2592000",
28
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/七里香/七里香.lrc"
29
},
30
{
31
"name": "花海",
32
"artist": "周杰伦",
33
"url": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/花海/花海.flac",
34
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002Neh8l0uciQZ_1.jpg?max_age=2592000",
35
"lrc": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/花海/花海.lrc"
36
},
37
{
38
"name": "反方向的钟",
39
"artist": "周杰伦",
40
"url": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/反方向的钟/反方向的钟.flac",
41
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000000f01724fd7TH_1.jpg?max_age=2592000",
42
"lrc": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/反方向的钟/反方向的钟.lrc"
43
},
44
{
45
"name": "兰亭序",
46
"artist": "周杰伦",
47
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.1/周杰伦/兰亭序/兰亭序.mp3",
48
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002Neh8l0uciQZ_1.jpg?max_age=2592000",
49
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.1/周杰伦/兰亭序/兰亭序.lrc"
50
},
51
{
52
"name": "说好的辛福呢",
53
"artist": "周杰伦",
54
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/说好的辛福呢/说好的辛福呢.mp3",
55
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002Neh8l0uciQZ_1.jpg?max_age=2592000",
56
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/说好的辛福呢/说好的幸福呢.lrc"
57
},
58
{
59
"name": "等你下课 (with 杨瑞代)",
60
"artist": "周杰伦",
61
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.1/周杰伦/等你下课/等你下课.mp3",
62
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000003bSL0v4bpKAx_1.jpg?max_age=2592000",
63
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.1/周杰伦/等你下课/等你下课.lrc"
64
},
65
{
66
"name": "我落泪情绪零碎",
67
"artist": "周杰伦",
68
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/我落泪情绪零碎/我落泪情绪零碎.mp3",
69
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000000bviBl4FjTpO_1.jpg?max_age=2592000",
70
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/我落泪情绪零碎/我落泪情绪零碎.lrc"
71
},
72
{
73
"name": "听妈妈的话",
74
"artist": "周杰伦",
75
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/听妈妈的话/听妈妈的话.mp3",
76
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002jLGWe16Tf1H_1.jpg?max_age=2592000",
77
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.2/听妈妈的话/听妈妈的话.lrc"
78
},
79
{
80
"name": "明明就",
81
"artist": "周杰伦",
82
"url": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/明明就/明明就.flac",
83
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000003Ow85E3pnoqi_1.jpg?max_age=2592000",
84
"lrc": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/明明就/明明就.lrc"
85
},
86
{
87
"name": "我是如此相信",
88
"artist": "周杰伦",
89
"url": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/我是如此相信/我是如此相信.flac",
90
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000001hGx1Z0so1YX_1.jpg?max_age=2592000",
91
"lrc": "https://npm.elemecdn.com/anzhiyu-music-jay@1.0.1/我是如此相信/我是如此相信.lrc"
92
},
93
{
94
"name": "发如雪",
95
"artist": "周杰伦",
96
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.3/发如雪/发如雪.mp3",
97
"cover": "https://y.qq.com/music/photo_new/T002R300x300M0000024bjiL2aocxT_3.jpg?max_age=2592000",
98
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.3/发如雪/发如雪.lrc"
99
},
100
{
101
"name": "以父之名",
102
"artist": "周杰伦",
103
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.3/以父之名/以父之名.mp3",
104
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000000MkMni19ClKG_3.jpg?max_age=2592000",
105
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.3/以父之名/以父之名.lrc"
106
},
107
{
108
"name": "园游会",
109
"artist": "周杰伦",
110
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.3/园游会/园游会.flac",
111
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000003DFRzD192KKD_1.jpg?max_age=2592000",
112
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.3/园游会/园游会.lrc"
113
},
114
{
115
"name": "本草纲目",
116
"artist": "周杰伦",
117
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.4/本草纲目/本草纲目.mp3",
118
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002jLGWe16Tf1H_1.jpg?max_age=2592000",
119
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.4/本草纲目/本草纲目.lrc"
120
},
121
{
122
"name": "龙卷风",
123
"artist": "周杰伦",
124
"url": "https://npm.elemecdn.com/anzhiyu-music@1.0.4/龙卷风/龙卷风.mp3",
125
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000000f01724fd7TH_1.jpg?max_age=2592000",
126
"lrc": "https://npm.elemecdn.com/anzhiyu-music@1.0.4/龙卷风/龙卷风.lrc"
127
}
128
]

展开收起

hexo 配置文件_config.yml中添加以下配置，注意不是主题配置文件

1
# APlayer
2
# https://github.com/MoePlayer/hexo-tag-aplayer/blob/master/docs/README-zh_cn.md
3
aplayer:
4
meting: true
5
asset_inject: false

主题配置文件中开启menu中我的和音乐馆的注释，注意缩进！！！

1
menu:
2
# 文章:
3
#   隧道: /archives/ || icon-box-archive
4
#   分类: /categories/ || icon-shapes
5
#   标签: /tags/ || icon-tags
6

7
友链:
8
友人帐: /link/ || icon-link
9
#   朋友圈: /fcircle/ || icon-artstation
10
#   留言板: /comments/ || icon-envelope
11

12
我的:
13
音乐馆: /music/ || icon-music
14
#   追番页: /bangumis/ || icon-bilibili1
15
#   相册集: /album/ || icon-images
16
#   小空调: /air-conditioner/ || icon-fan
17

18
关于:
19
#   关于本人: /about/ || icon-zhifeiji
20
闲言碎语: /essay/ || icon-lightbulb
21
#   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

如何修改默认歌单?

将menu中音乐馆的路径修改为以下格式即可/music/?id=1708664797&server=tencent，支持id和server参数。

id 与 server 的填写请参考MetingJS

音乐馆页

首页即刻说说页面配置

2025-01-23T12:32:13.000Z

首页即刻说说页面配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page essay

你会找到 source/essay/index.md 这个文件
修改这个文件：记得添加 type: "essay"

1
---
2
title: 即刻短文
3
date: 2020-07-22 22:06:17
4
comments: true
5
aside: false
6
top_img: false
7
type: essay
8
---

新建source/_data/essay.yml，输入以下内容，具体字段不做解释，可以依葫芦画瓢。

1
- title: 即刻短文
2
  subTitle: 咸鱼的日常生活。
3
  tips: 随时随地，分享生活
4
  buttonText: 关于我
5
  buttonLink: /about/
6
  limit: 30
7
  home_essay: true
8
  top_background: https://img02.anheyu.com/adminuploads/1/2022/08/21/630249e2df20f.jpg
9
  essay_list:
10
    - content: 安知鱼主题指南
11
      date: 2023/09/09
12
      video:
13
        - https://player.bilibili.com/player.html?aid=226886152&bvid=BV1Ch41137tR&cid=1081639816&p=1&autoplay=0
14
    - content: 支持了Accesskey快捷键，可以直接按下shift + ?组合键以查看快捷键选项。
15
      date: 2023/07/01
16
      video:
17
        - https://cdn.jsdelivr.net/npm/anzhiyu-blog-static@1.0.0/video/%E9%A3%8E%E8%BD%A6%E6%A0%B7%E5%BC%8F%E6%95%88%E6%9E%9C%E9%A2%84%E8%A7%88.mp4
18
      image:
19
        - https://img02.anheyu.com/adminuploads/1/2023/07/01/64a033cb2c21e.webp!blogimg
20
      address: 长沙
21
      from: 安知鱼
22
      link: /posts/e140.html
23
    - content: 音乐支持了参数设置自定义歌单
24
      date: 2023/01/02
25
      link: https://hexo.anheyu.com/music/?id=7269231710&server=tencent
26
    - content: 关于页的打赏仿了b站的充电功能，使用svg绘图➕一些动画参数移动，应该不会被b站警告吧😜，另外文章也支持了顶部随机b站同款春秋冬banner。
27
      date: 2022/12/18
28
    - content: React中不能直接修改state的一个重要原因是在性能优化时的prueComponment会进行浅层比较会认为是用一个对象且不能进入队列中批量更新
29
      date: 2022/12/10
30
    - content: 好耶，马上就可以放假回家了！好想家里的好吃的😋！才不是想捏妹妹的脸了
31
      date: 2022/12/06
32
    - content: 全局音乐的动画也处理好了, nice!
33
      date: 2022/11/13
34
    - content: 把页脚, 首页顶部全都魔改到本地了, 方便后续魔改, 音乐也改成胶囊的样式了, 其实还是想让胶囊可拖拽, 不可点击改变歌词位置的, 但是弄了半天都没弄好就放弃了
35
      date: 2022/11/13
36
    - content: 朋友圈船新版本终于写完了, 耶✌️
37
      date: 2022/11/05
38
      link: https://hexo.anheyu.com/album/
39
    - content: 终于把相册集搞定了, 耶✌️, 瀑布流在滑动滚动条一个视口范围上下100的情况执行一次, 到底部停止监听让性能高了好多，再也不会布局混乱🤪了
40
      date: 2022/10/25
41
      link: https://hexo.anheyu.com/album/
42
    - content: 搜索🔍支持缩略图显示啦（默认获取文章内容的第一张图片）
43
      date: 2022/10/23 08:00:00
44
      from: 安知鱼
45
    - content: 遇见彩虹🌈吃定彩虹
46
      date: 2022/10/23 10:00:00
47
      image:
48
        - https://bu.dusays.com/2023/04/09/64329399e285d.webp
49
        - https://bu.dusays.com/2023/04/09/64329399aa3bc.webp
50
        - https://bu.dusays.com/2023/04/09/6432939996dd7.webp
51
    - content: ThreeJs API真多丫
52
      date: 2022/10/19
53
    - content: 妹妹强制要求我买走了她的两幅画 -¥30
54
      date: 2022/10/02
55
      image:
56
        - https://bu.dusays.com/2023/04/09/643293997b92b.jpeg
57
    - content: 歌曲推荐
58
      date: 2022/09/25
59
      aplayer:
60
        server: tencent
61
        id: 001FGQba3i10mw
62
    - content: 做了一个噩梦, 梦到从楼顶坠下去了。😷
63
      date: 2022/09/24
64
    - content: JOJO是真的好看！
65
      date: 2022/09/21
66
      link: https://www.bilibili.com/bangumi/play/ss39431?spm_id_from=333.337.0.0

展开收起

【主题版本 1.6.7 以上支持】其中 video 对于 bilibili 进行的额外的支持，视频为 player.bilibili.com 的将显示为 bilibili 视频，并且可以在链接后面拼接&autoplay=0控制不自动播放

警告

主题配置文件中开启menu中关于和闲言碎语的注释，导航栏闲言碎语，注意缩进！！！

1
menu:
2
  # 文章:
3
  #   隧道: /archives/ || icon-box-archive
4
  #   分类: /categories/ || icon-shapes
5
  #   标签: /tags/ || icon-tags
6

7
  # 友链:
8
  #   友人帐: /link/ || icon-link
9
  #   朋友圈: /fcircle/ || icon-artstation
10
  #   留言板: /comments/ || icon-envelope
11

12
  # 我的:
13
  #   音乐馆: /music/ || icon-music
14
  #   追番页: /bangumis/ || icon-bilibili1
15
  #   相册集: /album/ || icon-images
16
  #   小空调: /air-conditioner/ || icon-fan
17

18
  关于:
19
    #   关于本人: /about/ || icon-zhifeiji
20
    闲言碎语: /essay/ || icon-lightbulb
21
    #   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

即刻说说页面

404页面配置

2025-01-23T12:32:13.000Z

404页面配置#

主题内置了一个简单的 404 页面，可在设置中开启本地预览时，访问出错的网站是不会跳到 404 页面的。

如需本地预览，请访问 http://localhost:4000/404.html

1
# A simple 404 page
2
error_404:
3
  enable: true
4
  subtitle: "页面没有找到"
5
  background:

404页面

基础配置

2025-01-23T12:32:13.000Z

站点配置 😋#

语言#

修改站点配置文件 _config.yml，不是主题配置文件。

默认语言是 en

主题支持三种语言

default(en)
zh-CN (简体中文)
zh-TW (繁体中文)

网站资料#

修改网站各种资料，例如标题、副标题和邮箱等个人资料，请修改博客根目录的_config.yml 。

网站资料

导航配置#

修改 主题配置文件

1
menu:
2
  文章:
3
    隧道: /archives/ || anzhiyu-icon-box-archive
4
    分类: /categories/ || anzhiyu-icon-shapes
5
    标签: /tags/ || anzhiyu-icon-tags
6

7
  友链:
8
    友人帐: /link/ || anzhiyu-icon-link
9
    朋友圈: /fcircle/ || anzhiyu-icon-artstation
10
    留言板: /comments/ || anzhiyu-icon-envelope
11

12
  我的:
13
    音乐馆: /music/ || anzhiyu-icon-music
14
    追番页: /bangumis/ || anzhiyu-icon-bilibili
15
    相册集: /album/ || anzhiyu-icon-images
16
    小空调: /air-conditioner/ || anzhiyu-icon-fan
17

18
  关于:
19
    关于本人: /about/ || anzhiyu-icon-paper-plane
20
    闲言碎语: /essay/ || anzhiyu-icon-lightbulb
21
    随便逛逛: javascript:toRandomPost() || anzhiyu-icon-shoe-prints1

展开收起

必须是 /xxx/，后面||分开，然后写图标名。

如果不希望显示图标，图标名可不写。

TIP 注意：导航的文字可自行更改

例如：

1
menu:
2
  Article:
3
    Tunnel: /archives/ || icon-box-archive
4
    Classification: /categories/ || icon-shapes
5
    Label: /tags/ || icon-tags
6

7
  Friend:
8
    Friends account: /link/ || icon-link
9
    Moments: /fcircle/ || icon-artstation
10
    Message board: /comments/ || icon-envelope
11

12
  My:
13
    Music Hall: /music/ || icon-music
14
    Chasing: /bangumis/ || icon-bilibili1
15
    Album Set: /album/ || icon-images
16
    Conditioning: /air-conditioner/ || icon-fan
17

18
  About: /about/ || icon-zhifeiji

展开收起

导航栏设置#

1
## nav相关配置
2
nav:
3
  enable: false
4
  travelling: false
5
  clock: true
6
  menu:
7
    - title: 网页
8
      item:
9
        - name: 博客
10
          link: https://hexo.anheyu.com/
11
          icon: /img/favicon.png
12
    - title: 项目
13
      item:
14
        - name: 安知鱼图床
15
          link: https://image.anheyu.com/
16
          icon: https://image.anheyu.com/favicon.ico

展开收起

参数	解释
enable	是否启用 nav 左侧项目按钮，仅控制左侧项目按钮
travelling	是否启用 nav 开往按钮
clock	是否启用 nav 左侧和风天气
menu	nav 左侧项目按钮内的菜单
menu.title	nav 左侧项目按钮内的菜单标题
menu.item	nav 左侧项目按钮内的菜单项
menu.item.name	nav 左侧项目按钮内的菜单项标题
menu.item.link	nav 左侧项目按钮内的菜单项链接
menu.item.icon	nav 左侧项目按钮内的菜单项图标

项目列表

代码块配置#

代码高亮主题#

AnZhiYu 支持 6 种代码高亮样式：

darker
pale night
light
ocean
mac
mac light

darker

darker

pale night

pale night

light

light

ocean

ocean

mac

mac

mac light

mac light

修改 主题配置文件

1
highlight_theme: light

代码复制#

主题支持代码复制功能，修改 主题配置文件

1
highlight_copy: true

代码框展开/关闭#

在默认情况下，代码框自动展开，可设置是否所有代码框都关闭状态，点击>可展开代码

true 全部代码框不展开，需点击>打开
false 代码框展开，有>点击按钮
none 不显示>按钮

修改主题配置文件

1
highlight_shrink: true #代码框不展开，需点击 '>' 打开

代码换行#

在默认情况下，Hexo 在编译的时候不会实现代码自动换行。如果你不希望在代码块的区域里有横向滚动条的话，那么你可以考虑开启这个功能。

修改 主题配置文件

1
code_word_wrap: true

如果你是使用 highlight 渲染，需要找到你站点的 Hexo 配置文件_config.yml，将 line_number 改成 false:

1
highlight:
2
  enable: true
3
  line_number: false # <- 改这里
4
  auto_detect: false
5
  tab_replace:

如果你是使用 prismjs 渲染，需要找到你站点的 Hexo 配置文件_config.yml，将 line_number 改成 false:

1
prismjs:
2
  enable: false
3
  preprocess: true
4
  line_number: false # <- 改这里
5
  tab_replace: ""

代码高度限制#

可配置代码高度限制，超出的部分会隐藏，并显示展开按钮，默认 330，可配置为 false。

1
highlight_height_limit: false # unit: px

注意：

单位是 px，直接添加数字，如 200
实际限制高度为 highlight_height_limit + 30 px ，多增加 30px 限制，目的是避免代码高度只超出 highlight_height_limit 一点时，出现展开按钮，展开没内容。
不适用于隐藏后的代码块（ css 设置 display: none）

图标配置#

AnZhiYu 支持阿里图标 (需配置自己的图标)，与 font-awesome v6 图标(需开启fontawesome)，使用阿里图标需配置主题配置文件中icon.ali_iconfont_js字段，默认内置部分图标，修改主题配置文件，视频教程: 安知鱼主题社交图标配置

1
icons:
2
  ali_iconfont_js: # 阿里图标symbol 引用链接，主题会进行加载 symbol 引用
3
  fontawesome: false #是否启用fontawesome6图标
4
  fontawesome_animation_css: #fontawesome_animation 如果有就会加载，示例值：https://npm.elemecdn.com/hexo-butterfly-tag-plugins-plus@1.0.17/lib/assets/font-awesome-animation.min.css

内置阿里图标库：https://www.iconfont.cn/collections/detail?cid=44481

使用方法，将图标库中的图标名复制，然后加上前缀anzhiyu-icon-即可，比如github图标，则为anzhiyu-icon-github。

社交图标#

书写格式 名称：url || icon名称

1
## social settings (社交图标设置)
2
## formal:
3
##   name: link || icon
4
social:
5
  # Github: https://github.com/anzhiyu-c || anzhiyu-icon-github
6
  # BiliBili: https://space.bilibili.com/372204786 || anzhiyu-icon-bilibili

如需 hover 动画生效需配置fontawesome_animation_css

1
icons:
2
  ali_iconfont_js: # 阿里图标symbol 引用链接，主题会进行加载 symbol 引用
3
  fontawesome: false #是否启用fontawesome6图标
4
  fontawesome_animation_css: #fontawesome_animation 如果有就会加载，示例值：https://npm.elemecdn.com/hexo-butterfly-tag-plugins-plus@1.0.17/lib/assets/font-awesome-animation.min.css

社交图标配置完以后个人卡片会出现图标内容，图标左边的内容为你的站点信息，在 hexo 的配置文件_config.yml中配置author和subtitle字段

个人卡片#

个人卡片 hover 后的显示描述，该描述请在侧边栏配置中的aside.card_author.description中修改，支持 html 显示。

卡片顶部的状态配置：

1
## 作者卡片 状态
2
author_status:
3
  enable: true
4
  # 可以是任何图片，建议放表情包或者emoji图片，效果都很好，[表情包速查](https://emotion.xiaokang.me/)
5
  statusImg: "https://bu.dusays.com/2023/08/24/64e6ce9c507bb.png"
6
  skills:
7
    - 🤖️ 数码科技爱好者
8
    - 🔍 分享与热心帮助
9
    - 🏠 智能家居小能手
10
    - 🔨 设计开发一条龙
11
    - 🤝 专修交互与设计
12
    - 🏃 脚踏实地行动派
13
    - 🧱 团队小组发动机
14
    - 💢 壮汉人狠话不多

顶部图#

文章置顶#

【推荐】hexo-generator-index 从 2.0.0 开始，已经支持文章置顶功能。你可以直接在文章的 front-matter 区域里添加 sticky: 1 属性来把这篇文章置顶。数值越大，置顶的优先级越大。

文章封面#

文章的 markdown 文档上,在 Front-matter 添加 cover ,并填上要显示的图片地址。

如果不配置 cover,可以设置显示默认的 cover。

如果不想在首页显示 cover, 可以设置为 false。

文章封面的获取顺序 Front-matter 的 cover > 配置文件的 default_cover > false

修改 主题配置文件

1
cover:
2
  # 是否显示文章封面
3
  index_enable: true
4
  aside_enable: true
5
  archives_enable: true
6
  # 封面显示的位置
7
  # 三个值可配置 left , right , both
8
  position: both
9
  # 当没有设置cover时，默认的封面显示
10
  default_cover:

参数	解释
index_enable	主页是否显示文章封面图
aside_enable	侧栏是否显示文章封面图
archives_enable	归档页面是否显示文章封面图
position	主页卡片文章封面的显示位置 - left：全部显示在左边 - right：全部显示在右边 - both：封面位置以左右左右轮流显示
default_cover	默认的 cover, 可配置图片链接/顔色/渐变色等

当配置多张图片时,会随机选择一张作为 cover.此时写法应为

1
default_cover:
2
  - https://file.crazywong.com/gh/jerryc127/CDN@latest/cover/default_bg.png
3
  - https://file.crazywong.com/gh/jerryc127/CDN@latest/cover/default_bg2.png
4
  - https://file.crazywong.com/gh/jerryc127/CDN@latest/cover/default_bg3.png

文章 meta 显示#

这个选项是用来显示文章的相关信息的。

修改 主题配置文件

1
post_meta:
2
  page:
3
    date_type: both # created or updated or both 主页文章日期是创建日或者更新日或都显示
4
    date_format: relative # date/relative 显示日期还是相对日期
5
    category: true # true or false 主页是否显示分类
6
    tags: true # true or false 主页是否显示标签
7
    label: true # true or false 显示描述性文字
8
  post:
9
    date_type: both # created or updated or both 文章页日期是创建日或者更新日或都显示
10
    date_format: relative # date/relative 显示日期还是相对日期
11
    category: true # true or false 文章页是否显示分类
12
    tags: true # true or false 文章页是否显示标签
13
    label: true # true or false 显示描述性文字

主页文章页

date_format配置时间显示明确时间还是相对时间

文章版权#

为你的博客文章展示文章版权和许可协议。

修改 主题配置文件

1
post_copyright:
2
  enable: true
3
  decode: false
4
  author_href:
5
  license: CC BY-NC-SA 4.0
6
  license_url: https://creativecommons.org/licenses/by-nc-sa/4.0/

由于 Hexo 4.1 开始，默认对网址进行解码，以至于如果是中文网址，会被解码，可设置 decode: true 来显示中文网址。

如果有文章（例如：转载文章）不需要显示版权，可以在文章 Front-matter 单独设置

1
copyright: false

支持对单独文章设置版权信息，可以在文章 Front-matter 单独设置

1
copyright_author: xxxx
2
copyright_author_href: https://xxxxxx.com
3
copyright_url: https://xxxxxx.com
4
copyright_info: 此文章版权归xxxxx所有，如有转载，请注明来自原作者

文章打赏#

在你每篇文章的结尾，可以添加打赏按钮。相关二维码可以自行配置。

对于没有提供二维码的，可配置一张软件的 icon 图片，然后在 link 上添加相应的打赏链接。用户点击图片就会跳转到链接去。

link 可以不写，会默认为图片的链接。coinAudio 为投币的音频。

修改 主题配置文件

1
reward:
2
  enable: true
3
  coinAudio: https://npm.elemecdn.com/akilar-candyassets@1.0.36/audio/aowu.m4a
4
  QR_code:
5
    - img: https://npm.elemecdn.com/anzhiyu-blog@1.1.6/img/post/common/qrcode-weichat.png
6
      link:
7
      text: wechat
8
    - img: https://npm.elemecdn.com/anzhiyu-blog@1.1.6/img/post/common/qrcode-alipay.png
9
      link:
10
      text: alipay

TOC#

在文章页，会有一个目录，用于显示 TOC。修改 主题配置文件

1
toc:
2
  post: true
3
  page: true
4
  number: true
5
  expand: false
6
  style_simple: false # for post

属性	解释
post	文章页是否显示 TOC
page	普通页面是否显示 TOC
number	是否显示章节数
expand	是否展开 TOC
style_simple	简洁模式（侧边栏只显示 TOC, 只对文章页有效）

为特定的文章配置

在你的文章 md 文件的头部，加入 toc_number 和 toc，并配置 true 或者 false 即可。

主题会优先判断文章 Markdown 的 Front-matter 是否有配置，如有，则以 Front-matter 的配置为准。否则，以主题配置文件中的配置为准

文章过期提醒#

可设置是否显示文章过期提醒，以更新时间为基准。

1
## Displays outdated notice for a post (文章过期提醒)
2
noticeOutdate:
3
  enable: true
4
  style: flat # style: simple/flat
5
  limit_day: 365 # When will it be shown
6
  position: top # position: top/bottom
7
  message_prev: It has been
8
  message_next: days since the last update, the content of the article may be outdated.

limit_day：距离更新时间多少天才显示文章过期提醒

message_prev：天数之前的文字

message_next：天数之后的文字

文章编辑按钮#

在文章标题旁边显示一个编辑按钮，点击会跳转到对应的链接去。

1
## Post edit
2
## Easily browse and edit blog source code online.
3
post_edit:
4
  enable: false
5
  # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/
6
  # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/
7
  url:

文章分页按钮#

Warning

当文章封面设置为 false 时，或者没有获取到封面配置，分页背景将会显示主题色。

可设置分页的逻辑，也可以关闭分页显示

1
## post_pagination (分页)
2
## value: 1 || 2 || false
3
## 1: The 'next post' will link to old post
4
## 2: The 'next post' will link to new post
5
## false: disable pagination
6
post_pagination: false

参数	解释
post_pagination: false	关闭分页按钮
post_pagination: 1	下一篇显示的是旧文章
post_pagination: 2	下一篇显示的是新文章

中控台#

主题配置文件中，默认为true

1
## 中控台
2
centerConsole: true

友情链接配置

2025-01-23T12:32:13.000Z

友情链接配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page link

你会找到 source/link/index.md 这个文件
修改这个文件：记得添加 type: "link"

1
---
2
title: link
3
date: 2020-12-01 22:19:45
4
type: "link"
5
---

新建文件source\_data\link.yml,没有_data文件夹的话也请自己新建。以下是默认友链格式示例(自己写的教程，夹带点私货不过分吧，嘻嘻)。打开[blog]\source\_data\link.yml，输入：

1
- class_name: 框架
2
flink_style: flexcard
3
hundredSuffix: ""
4
link_list:
5
- name: Hexo
6
link: https://hexo.io/zh-tw/
7
avatar: https://d33wubrfki0l68.cloudfront.net/6657ba50e702d84afb32fe846bed54fba1a77add/827ae/logo.svg
8
descr: 快速、简单且强大的网站框架
9
- name: anzhiyu主题
10
link: https://hexo.anheyu.com/
11
avatar: https://npm.elemecdn.com/anzhiyu-blog-static@1.0.4/img/avatar.jpg
12
descr: 生活明朗，万物可爱
13
siteshot: https://npm.elemecdn.com/anzhiyu-theme-static@1.1.6/img/hexo.anheyu.com.jpg
14

15
- class_name: 推荐博客
16
flink_style: telescopic
17
hundredSuffix: ""
18
link_list:
19
- name: 安知鱼
20
link: https://hexo.anheyu.com/
21
avatar: https://npm.elemecdn.com/anzhiyu-blog-static@1.0.4/img/avatar.jpg
22
descr: 生活明朗，万物可爱
23
siteshot: https://npm.elemecdn.com/anzhiyu-theme-static@1.1.6/img/hexo.anheyu.com.jpg
24
color: vip
25
tag: 技术
26

27
- class_name: 小伙伴
28
class_desc: 那些人，那些事
29
flink_style: anzhiyu
30
hundredSuffix: ""
31
link_list:
32
- name: 安知鱼
33
link: https://hexo.anheyu.com/
34
avatar: https://npm.elemecdn.com/anzhiyu-blog-static@1.0.4/img/avatar.jpg
35
descr: 生活明朗，万物可爱
36
recommend: true

展开收起

参数	解释
class_name	【必填】友链分类名
class_desc	【可选】友链分类描述
flink_style	【必填】`flexcard`或者`anzhiyu`或者`telescopic`
hundredSuffix	【可选】解决共同进步板块头像质量问题，配置后共同进步板块的头像会添加该后缀（请确保你的图片加上 hundredSuffix 的配置后依然可以访问）。例如:`hundredSuffix: "!w120"`
link_list	【必须】友链列表
link_list.name	【必须】友链名称
link_list.link	【必须】友链链接
link_list.avatar	【必须】友链头像
link_list.descr	【必须】友链描述
link_list.siteshot	【可选】flink_style 为 flexcard 或 telescopic 时友链的站点图片
link_list.recommend	【可选】快捷选项，等于`color:""` + `tag: "荐"`
link_list.tag	【可选】左上角的 tag，为当前友链打上标签例如:“推荐”
link_list.color	【可选】tag 的十六进制背景颜色例如: “#646cff”，提供了两个快捷颜色选项分别是`vip`和`speed`

主题配置文件中开启menu中友链和友人帐的注释，注意缩进！！！

1
menu:
2
  # 文章:
3
  #   隧道: /archives/ || icon-box-archive
4
  #   分类: /categories/ || icon-shapes
5
  #   标签: /tags/ || icon-tags
6

7
  友链:
8
    友人帐: /link/ || icon-link
9
  #   朋友圈: /fcircle/ || icon-artstation
10
  #   留言板: /comments/ || icon-envelope
11

12
  # 我的:
13
  #   音乐馆: /music/ || icon-music
14
  #   追番页: /bangumis/ || icon-bilibili1
15
  #   相册集: /album/ || icon-images
16
  #   小空调: /air-conditioner/ || icon-fan
17

18
  关于:
19
    #   关于本人: /about/ || icon-zhifeiji
20
    闲言碎语: /essay/ || icon-lightbulb
21
    #   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

773950733a554df09fced27d0e1128636432641611b97.png

与数百博主共同进步#

在主题配置文件中_config.anzhiyu.yml中配置

1
# 友情链接顶部相关配置
2
linkPageTop:
3
  enable: true
4
  title: 与数百名博主无限进步
5
  # 添加博主友链的评论自定义格式
6
  addFriendPlaceholder: "昵称（请勿包含博客等字样）：\n网站地址（要求博客地址，请勿提交个人主页）：\n头像图片url（请提供尽可能清晰的图片，我会上传到我自己的图床）：\n描述：\n站点截图（可选）：\n"

与数百博主共同进步

建议超过 30 以上的友链数开启，友链数目不够会导致头像无法铺满。

我的装备页面配置

2025-01-23T12:32:13.000Z

我的装备页面配置#

前往你的 Hexo 博客的根目录在 Hexo 博客根目录 [blog] 下打开终端，输入

Terminal window

1
hexo new page equipment

你会找到 source/equipment/index.md 这个文件

修改这个文件：记得添加 type: "equipment"

1
title: 我的装备
2
date: 2023-06-10 21:33:24
3
type: equipment
4
aside: false
5
top_img: false

添加数据，新建文件source\_data\equipment.yml,没有_data文件夹的话也请自己新建。以下是默认格式示例，打开source\_data\equipment.yml，输入

1
- class_name: 好物
2
  description: 实物装备推荐
3
  tip: 跟 安知鱼 一起享受科技带来的乐趣
4
  top_background: https://bu.dusays.com/2023/07/05/64a4c38842b7a.webp
5
  good_things:
6
    - title: 生产力
7
      description: 提升自己生产效率的硬件设备
8
      equipment_list:
9
        - name: MacBook Pro 2021 16 英寸
10
          specification: M1 Max 64G / 1TB
11
          description: 屏幕显示效果好、色彩准确、对比度强、性能强劲、续航优秀。可以用来开发和设计。
12
          image: https://bu.dusays.com/2023/07/05/64a4c3b191e2e.png
13
          link: /posts/571d.html
14
        - name: iPad 2020
15
          specification: 深空灰 / 128G
16
          description: 事事玩得转，买前生产力，买后爱奇艺。
17
          image: https://bu.dusays.com/2023/07/05/64a4c3b191e2e.png
18
          link: https://www.apple.com.cn/ipad-10.2/
19
        - name: iPhone 12 mini
20
          specification: 绿色 / 128G
21
          description: 超瓷晶面板，玻璃背板搭配铝金属边框，曲线优美的圆角设计，mini大小正好一只手就抓住，深得我心，唯一缺点大概就是续航不够。
22
          image: https://bu.dusays.com/2023/07/05/64a4c3ded6319.webp
23
          link: https://www.apple.com.cn/iphone-12/specs/
24
        - name: AirPods（第三代）
25
          specification: 标准版
26
          description: 第三代对比第二代提升很大，和我一样不喜欢入耳式耳机的可以入，空间音频等功能确实新颖，第一次使用有被惊艳到。
27
          image: https://bu.dusays.com/2023/07/05/64a4c3ded6319.webp
28
          link: https://www.apple.com.cn/airpods-3rd-generation/
29
    - title: 出行
30
      description: 用来出行的实物及设备
31
      equipment_list:
32
        - name: Apple Watch Series 8
33
          specification: 黑色
34
          description: 始终为我的健康放哨，深夜弹出站立提醒，不过确实有效的提高了我的运动频率，配合apple全家桶还是非常棒的产品，缺点依然是续航。
35
          image: https://bu.dusays.com/2023/07/05/64a4c40ab698a.webp
36
          link: https://www.apple.com.cn/apple-watch-series-8/
37
        - name: NATIONAL GEOGRAPHIC双肩包
38
          specification: 黑色
39
          description: 国家地理黑色大包，正好装下16寸 Macbook Pro，并且背起来很舒适，底部自带防雨罩也好用，各种奇怪的小口袋深得我心。
40
          image: https://bu.dusays.com/2023/07/05/64a4c40ab698a.webp
41
          link: https://item.jd.com/100011269828.html
42
        - name: NATIONAL GEOGRAPHIC学生书包🎒
43
          specification: 红白色
44
          description: 国家地理黑色大包，冰冰🧊同款，颜值在线且实用。
45
          image: https://bu.dusays.com/2023/07/05/64a4c40ab698a.webp
46
          link: https://item.jd.com/100005889786.html

展开收起

主题配置文件中开启menu中关于和我的装备的注释，导航栏我的装备，注意缩进！！！

1
menu:
2
  # 文章:
3
  #   隧道: /archives/ || anzhiyu-icon-box-archive
4
  #   分类: /categories/ || anzhiyu-icon-shapes
5
  #   标签: /tags/ || anzhiyu-icon-tags
6

7
  # 友链:
8
  #   友人帐: /link/ || anzhiyu-icon-link
9
  #   朋友圈: /fcircle/ || anzhiyu-icon-artstation
10
  #   留言板: /comments/ || anzhiyu-icon-envelope
11

12
  # 我的:
13
  #   音乐馆: /music/ || anzhiyu-icon-music
14
  #   追番页: /bangumis/ || anzhiyu-icon-bilibili
15
  #   相册集: /album/ || anzhiyu-icon-images
16
  #   小空调: /air-conditioner/ || anzhiyu-icon-fan
17

18
  关于:
19
    #   关于本人: /about/ || anzhiyu-icon-paper-plane
20
    #   闲言碎语: /essay/ || anzhiyu-icon-lightbulb
21
    #   随便逛逛: javascript:toRandomPost() || anzhiyu-icon-shoe-prints1
22
    我的装备: /equipment/ || anzhiyu-icon-dice-d20

展开收起

Front-matter 的基本认识

2025-01-23T12:32:13.000Z

🧱 Front-matter 的基本认识#

Front-matter 是 markdown 文件最上方以 --- 分隔的区域，用于指定个别档案的变数。其中又分为两种 markdown 里

Page Front-matter 用于页面配置
Post Front-matter 用于文章页配置

TIP 如果标注可选的参数，可根据自己需要添加，不用全部都写在 markdown 里

Page Front-matter#

1
title:
2
date:
3
updated:
4
type:
5
comments:
6
description:
7
keywords:
8
top_img:
9
mathjax:
10
katex:
11
aside:
12
aplayer:
13
highlight_shrink:
14
type:
15
top_single_background:

展开收起

写法	解释
title	【必需】页面标题
date	【必需】页面创建日期
type	【必需】标签、分类、关于、音乐馆、友情链接、相册、相册详情、朋友圈、即刻页面需要配置
updated	【可选】页面更新日期
description	【可选】页面描述
keywords	【可选】页面关键字
comments	【可选】显示页面评论模块(默认 true)
top_img	【可选】页面顶部图片
mathjax	【可选】显示 mathjax(当设置 mathjax 的 per_page: false 时，才需要配置，默认 false)
katex	【可选】显示 katex(当设置 katex 的 per_page: false 时，才需要配置，默认 false)
aside	【可选】显示侧边栏 (默认 true)
aplayer	【可选】在需要的页面加载 aplayer 的 js 和 css,请参考文章下面的音乐配置
highlight_shrink	【可选】配置代码框是否展开(true/false)(默认为设置中 highlight_shrink 的配置)
top_single_background	【可选】部分页面的顶部模块背景图片

Post Front-matter#

1
title:
2
date:
3
updated:
4
tags:
5
category:
6
keywords:
7
description:
8
top_img:
9
comments:
10
cover:
11
toc:
12
toc_number:
13
toc_style_simple:
14
copyright:
15
copyright_author:
16
copyright_author_href:
17
copyright_url:
18
copyright_info:
19
mathjax:
20
katex:
21
aplayer:
22
highlight_shrink:
23
aside:
24
swiper_index: 1
25
top_group_index: 1
26
background: "#fff"

展开收起

写法	解释
title	【必需】文章标题
date	【必需】文章创建日期
updated	【可选】文章更新日期
tags	【可选】文章标签
categories	【可选】文章分类
keywords	【可选】文章关键字
description	【可选】文章描述
top_img	【可选】文章顶部图片
cover	【可选】文章缩略图(如果没有设置 top_img,文章页顶部将显示缩略图，可设为 false/图片地址/留空)
comments	【可选】显示文章评论模块(默认 true)
toc	【可选】显示文章 TOC(默认为设置中 toc 的 enable 配置)
toc_number	【可选】显示 toc_number(默认为设置中 toc 的 number 配置)
toc_style_simple	【可选】显示 toc 简洁模式
copyright	【可选】显示文章版权模块(默认为设置中 post_copyright 的 enable 配置)
copyright_author	【可选】文章版权模块的`文章作者`
copyright_author_href	【可选】文章版权模块的`文章作者`链接
copyright_url	【可选】文章版权模块的`文章链接`链接
copyright_info	【可选】文章版权模块的版权声明文字
mathjax	【可选】显示 mathjax(当设置 mathjax 的 per_page: false 时，才需要配置，默认 false)
katex	【可选】显示 katex(当设置 katex 的 per_page: false 时，才需要配置，默认 false)
aplayer	【可选】在需要的页面加载 aplayer 的 js 和 css,请参考文章下面的`音乐` 配置
highlight_shrink	【可选】配置代码框是否展开(true/false)(默认为设置中 highlight_shrink 的配置)
aside	【可选】显示侧边栏 (默认 true)
swiper_index	【可选】首页轮播图配置 index 索引，数字越小越靠前
top_group_index	【可选】首页右侧卡片组配置, 数字越小越靠前
ai	【可选】文章ai摘要
main_color	【可选】文章主色，必须是16进制颜色且有6位，不可缩减，例如#ffffff 不可写成#fff

首页轮播图配置: swiper_index, 数字越小越靠前
首页卡片配置: top_group_index, 数字越小越靠前
page 中top_single_background, 可配置部分页面的顶部背景图片

TIP 只需要在你的文章顶部的Front-matter配置这swiper_index和top_group_index两个字段即可显示轮播图和推荐卡片

全局配置

2025-01-23T12:32:13.000Z

评论#

开启评论需要在 comments-use 中填写你需要的评论。

支持双评论显示，只需要配置两个评论（第一个为默认显示）

1
comments:
2
  # Up to two comments system, the first will be shown as default
3
  # Choose: Valine/Waline/Twikoo/
4
  use: Twikoo,Waline # Twikoo/Waline
5
  text: true # Display the comment name next to the button
6
  # lazyload: The comment system will be load when comment element enters the browser's viewport.
7
  # If you set it to true, the comment count will be invalid
8
  lazyload: false
9
  count: true # Display comment count in post's top_img
10
  card_post_count: false # Display comment count in Home Page

参数	解释
use	使用的评论（请注意，最多支持两个，如果不需要请留空）
text	是否显示评论服务商的名字
lazyload	是否为评论开启 lazyload，开启后，只有滚动到评论位置时才会加载评论所需要的资源（开启 lazyload 后，评论数将不显示）
count	是否在文章顶部显示评论数
card_post_count	是否在首页文章卡片显示评论数

Twikoo#

Twikoo 是一个简洁、安全、无后端的静态网站评论系统，基于腾讯云开发。

具体如何配置评论，请查看 Twikoo 文档

你只需要把获取到的 环境 ID (envId) 填写到配置上去就行

修改 主题配置文件

1
# Twikoo
2
# https://github.com/imaegoo/twikoo
3
twikoo:
4
  envId:
5
  region:
6
  visitor: false
7
  option:

参数	解释
envId	环境 ID
region	环境地域，默认为 ap-shanghai，如果您的环境地域不是上海，需传此参数
visitor	是否显示文章阅读数
option	可选配置
card_post_count	是否在首页文章卡片显示评论数

开启 visitor 后，文章页的访问人数将改为 Twikoo 提供，而不是 不蒜子

Valine#

遵循 Valine 的指示去配置你的 LeanCloud 应用。以及查看相应的配置说明。

然后修改 主题配置文件:

1
valine:
2
  appId: # leancloud application app id
3
  appKey: # leancloud application app key
4
  avatar: monsterid # gravatar style https://valine.js.org/#/avatar
5
  serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in)
6
  bg: # valine background
7
  visitor: false
8
  option:

开启 visitor 后，文章页的访问人数将改为 Valine 提供，而不是不蒜子

Valine 于 v1.4.5 开始支持自定义表情，如果你需要自行配置，请在 emojiCDN 配置表情 CDN。

同时在 Hexo 工作目录下的 source/_data/创建一个 json 文件 valine.json,等同于 Valine 需要配置的 emojiMaps，valine.json 配置方式可参考如下

1
{
2
  "tv_doge": "6ea59c827c414b4a2955fe79e0f6fd3dcd515e24.png",
3
  "tv_亲亲": "a8111ad55953ef5e3be3327ef94eb4a39d535d06.png",
4
  "tv_偷笑": "bb690d4107620f1c15cff29509db529a73aee261.png",
5
  "tv_再见": "180129b8ea851044ce71caf55cc8ce44bd4a4fc8.png",
6
  "tv_冷漠": "b9cbc755c2b3ee43be07ca13de84e5b699a3f101.png",
7
  "tv_发怒": "34ba3cd204d5b05fec70ce08fa9fa0dd612409ff.png",
8
  "tv_发财": "34db290afd2963723c6eb3c4560667db7253a21a.png",
9
  "tv_可爱": "9e55fd9b500ac4b96613539f1ce2f9499e314ed9.png",
10
  "tv_吐血": "09dd16a7aa59b77baa1155d47484409624470c77.png",
11
  "tv_呆": "fe1179ebaa191569b0d31cecafe7a2cd1c951c9d.png",
12
  "tv_呕吐": "9f996894a39e282ccf5e66856af49483f81870f3.png",
13
  "tv_困": "241ee304e44c0af029adceb294399391e4737ef2.png",
14
  "tv_坏笑": "1f0b87f731a671079842116e0991c91c2c88645a.png",
15
  "tv_大佬": "093c1e2c490161aca397afc45573c877cdead616.png",
16
  "tv_大哭": "23269aeb35f99daee28dda129676f6e9ea87934f.png",
17
  "tv_委屈": "d04dba7b5465779e9755d2ab6f0a897b9b33bb77.png",
18
  "tv_害羞": "a37683fb5642fa3ddfc7f4e5525fd13e42a2bdb1.png",
19
  "tv_尴尬": "7cfa62dafc59798a3d3fb262d421eeeff166cfa4.png",
20
  "tv_微笑": "70dc5c7b56f93eb61bddba11e28fb1d18fddcd4c.png",
21
  "tv_思考": "90cf159733e558137ed20aa04d09964436f618a1.png",
22
  "tv_惊吓": "0d15c7e2ee58e935adc6a7193ee042388adc22af.png"
23
}

展开收起

Waline#

Waline - 一款从 Valine 衍生的带后端评论系统。可以将 Waline 等价成 With backend Valine。

具体配置可参考 waline 文档

然后修改主题配置文件:

1
waline:
2
  serverURL: # Waline server address url
3
  bg: # waline background
4
  pageview: false
5
  option:

开启 pageview 后，文章页的访问人数将改为 Waline 提供，而不是不蒜子

在线聊天#

通用配置#

这些工具都提供了一个按钮可以打开/关闭聊天窗口。主题也提供了一个集合主题特色的按钮来替换这些工具本身的按钮，这个聊天按钮将会出现在右下角里。你只需要把 chat_btn 打开就行。

修改 主题配置文件

1
# Chat Button [recommend]
2
# It will create a button in the bottom right corner of website, and hide the origin button
3
chat_btn: true

为了不影响访客的体验，主题提供一个 chat_hide_show 配置设为 true 后，使用工具提供的按钮时，只有向上滚动才会显示聊天按钮，向下滚动时会隐藏按钮。

修改 主题配置文件

1
# The origin chat button is displayed when scrolling up, and the button is hidden when scrolling down
2
chat_hide_show: true

如果使用工具自带的聊天按钮，按钮位置可能会遮挡右下角图标，请配置 rightside-bottom 调正右下角图标位置

chatra#

配置 chatra,需要知道 Public key

打开 chatra 并注册账号。你可以在 Preferences 中找到 Public key

修改 主题配置文件

1
# chatra
2
# https://chatra.io/
3
chatra:
4
  enable: true
5
  id: xxxxxxxx

chatra 的样式你可以 Chat Widget 自行配置

tidio#

配置 tidio,需要知道 Public key

打开 tidio 并注册账号。你可以在 Preferences > Developer 中找到 Public key

修改 主题配置文件

1
# tidio
2
# https://www.tidio.com/
3
tidio:
4
  enable: true
5
  public_key: XXXX

tidio的样式你可以Channels自行配置

daovoice#

打开 daovoice 和注册帐号

找到你的 app id

修改 主题配置文件

1
# daovoice
2
# http://daovoice.io/
3
daovoice:
4
  enable: true
5
  app_id: xxxxx

可在聊天设置里配置聊天按钮等样式

crisp#

打开 crisp 并注册帐号

找到需要的网站 ID

1
# crisp
2
# https://crisp.chat/en/
3
crisp:
4
  enable: false
5
  website_id: xxxxxxxx

messenger#

messenger 为 Facebook 旗下的聊天服务

具体操作请查看 Facebook 洽谈附加程式 - Messenger 平台

1
messenger:
2
  enable: false
3
  pageID: xxxxx
4
  lang: zh_TW # Language en_US/zh_CN/zh_TW and so on

ai 摘要#

需主题版本大于 1.1.6 版本

修改主题配置文件，其中key和Referer 为 tianli gpt 的key和Referer，可在 https://afdian.net/item/886a79d4db6711eda42a52540025c377 购买 key，购买完成后请立即在前端面板绑定 key，以防止被盗用。

适用于 AnZhiYu 主题项目的 Key，前端管理面板 https://summary.tianli0.top/

每个 key 限制请求字数 50000 字，如果是已经请求过的内容不会再次消耗 key 使用时需要绑定 key。虚拟物品一经发出不支持退款。

关于续费：续费和绑定流程相同，绑定成功后会自动充值到原有的 key 上，也就是说无需更改网页中的 key 参数，直接绑定即可。格式发送，返回的 token 即你的剩余字数

yaml

1
# 文章顶部ai摘要
2
post_head_ai_description:
3
  enable: true
4
  gptName: AnZhiYu
5
  mode: local # 默认模式 可选值: tianli/local
6
  switchBtn: false # 可以配置是否显示切换按钮 以切换tianli/local
7
  btnLink: https://afdian.net/item/886a79d4db6711eda42a52540025c377
8
  randomNum: 3 # 按钮最大的随机次数，也就是一篇文章最大随机出来几种
9
  basicWordCount: 1000 # 最低获取字符数, 最小1000, 最大1999
10
  key: xxxx
11
  Referer: https://xx.xx/

配置完成以后在文章的Front-matter配置ai: true 使用 tianli gpt 需将 mode 改为tianli 然后在需要 ai 摘要的文章的Front-matter配置ai: true

如果使用local,需要按照以下方式配置

1
---
2
title: AnZhiYu主题快速开始
3
ai:
4
  - 本教程介绍了如何在博客中安装基于Hexo主题的安知鱼主题，并提供了安装、应用主题、修改配置文件、本地启动等详细步骤及技术支持方式。教程的内容针对最新的主题版本进行更新，如果你是旧版本教程会有出入。
5
  - 本文真不错
6
---

mode	对比
tianli	具有完备的训练后端功能，可优秀的完成文章的摘要，方便的快速生成对应摘要
local	本地，需自行在文章顶部添加 ai 摘要，内容自行决定，书写较为麻烦。

控制台信息#

关于控制台信息，主题不提供修改配置，但是可以在主题配置文件中进行关闭。

1
# 控制台打印信息
2
console:
3
  enable: true

控制台打印时间相关信息可以配置页脚内容来修改。

1
footer:
2
  owner:
3
    enable: true
4
    since: 2020
5
  custom_text:
6
  copyright: false # Copyright of theme and framework
7
  runtime:
8
    enable: true
9
    launch_time: 04/01/2021 00:00:00 # 网站上线时间
10
    work_img: https://npm.elemecdn.com/anzhiyu-blog@2.0.4/img/badge/安知鱼-上班摸鱼中.svg
11
    work_description: 距离月入25k也就还差一个大佬带我~
12
    offduty_img: https://npm.elemecdn.com/anzhiyu-blog@2.0.4/img/badge/安知鱼-下班啦.svg
13
    offduty_description: 下班了就该开开心心的玩耍，嘿嘿~

如果实在有强迫症也可以自行修改内容themes/anzhiyu/layout/includes/anzhiyu/log-js.pug。

控制台打印信息

如何配置首页顶部右侧不使用轮播图#

效果预览

将主题配置文件中home_top.swiper.enable 修改为 false 即可.

标签卖萌#

主题配置文件中

1
# 标签卖萌
2
diytitle:
3
  enable: true
4
  leaveTitle: w(ﾟДﾟ)w 不要走！再看看嘛！
5
  backTitle: ♪(^∇^*)欢迎肥来！

配置关于页与文章页底部打赏二维码#

在主题配置文件中

1
# Sponsor/reward
2
reward:
3
  enable: true
4
  coinAudio: https://npm.elemecdn.com/akilar-candyassets@1.0.36/audio/aowu.m4a
5
  QR_code:
6
    - img: https://npm.elemecdn.com/anzhiyu-blog@1.1.6/img/post/common/qrcode-weichat.png
7
      link:
8
      text: wechat
9
    - img: https://npm.elemecdn.com/anzhiyu-blog@1.1.6/img/post/common/qrcode-alipay.png
10
      link:
11
      text: alipay

主题如何获取文章主色调#

支持在文章Post Front-matter配置主色main_color，例如

1
---
2
title: AnZhiYu主题安装文档（一）
3
date: 2023-03-26 18:55:44
4
main_color: "#c0e0e0"
5
---

主题将会优先获取文章Post Front-matter颜色，如果未设置才会使用cdn/api/both

1
# 主色调相关配置
2
mainTone:
3
  enable: true # true or false 文章是否启用获取图片主色调
4
  mode: both # cdn/api/both cdn模式为图片url+imageAve参数获取主色调，api模式为请求API获取主色调，both模式会先请求cdn参数，无法获取的情况下将请求API获取
5
  # 项目地址：https://github.com/anzhiyu-c/img2color-go
6
  api: https://color.anheyu.com/api?img= # mode为api时可填写
7
  cover_change: true # 整篇文章跟随cover修改主色调

参数	解释
enable	是否开启主色调
mode	cdn/api/both cdn 模式为图片 url+imageAve 参数获取主色调，api 模式为请求 API 获取主色调，both 模式会先请求 cdn 参数，无法获取的情况下将请求 API 获取（目前 cdn 模式支持多吉云和腾讯数据万象两种方式）
api	mode 为 api 时，需返回 16 进制颜色，可以参考部署项目: https://github.com/anzhiyu-c/img2color-go
cover_change	整篇文章跟随 cover 修改主色调

双栏#

如果你需要像我一样首页双栏，修改主题配置文件_config.anzhiyu.yml（主题版本需要 1.1.1 以及以上）

1
# 双栏文章
2
article_double_row: true

首页顶部 3 大分类配置#

首页技能点轮播下的分类，可通过配置主题配置文件home_top

Terminal window

1
hexo new page categories

1
---
2
title: Hello World
3
category: 前端开发
4
---

只需要在创建分类以后在对应的文章中添加上对应的分类，配置 path 即可，注意一定要对应。

左下角音乐球#

歌单配置很简单，只需要修改主题配置文件中nav_music即可.

其中 id 与 server 配置可以参考MetingJS

option	default	description
id	require	song id / playlist id / album id / search keyword
server	require	music platform: `netease`, `tencent`, `kugou`, `xiami`, `baidu`

1
# 左下角音乐配置项
2
# https://github.com/metowolf/MetingJS
3
nav_music:
4
  enable: true
5
  console_widescreen_music: false # 宽屏状态控制台显示音乐而不是标签 enable为true 控制台依然会显示
6
  id: 8152976493
7
  server: netease
8
  all_playlist: https://y.qq.com/n/ryqq/playlist/8802438608

nav_music

评论匿名邮箱#

目前只支持 Twikoo

1
# 评论匿名邮箱
2
visitorMail:
3
  enable: true
4
  mail: visitor@anheyu.com

8b137612742545af9e113d3f7ca0c724ff8c3b886c1458502c6ee380fca57242_541291655091259594.png

文章底部工具#

1
# ptool 文章底部工具
2
ptool:
3
  enable: true
4
  share_mobile: true
5
  share_weibo: true
6
  share_copyurl: true
7
  category: false # 是否显示分类
8
  mode: /wechat/ # 运营模式与责任，不配置不显示

3dc3656d3f244c5297925cc50d34aedb207dcb8f055b525fdbb993de52709e90_5925419818209142417.png

首页技能点配置#

[blog]代表你的博客根目录。示例数据中的图片链接为本人图床，请自行上传至您自己的图床，（不保证永久可用性）。

主题配置文件，关闭peoplecanvas.enable

1
# 首页随便逛逛people模式 而非技能点模式，关闭后为技能点模式需要配置creativity.yml
2
peoplecanvas:
3
  enable: false
4
  img: https://upload-bbs.miyoushe.com/upload/2024/07/27/125766904/ee23df8517f3c3e3efc4145658269c06_236200206013649395..png
5

6
  # 备用图片（如上面的失效可以用这张） https://upload-bbs.miyoushe.com/upload/2024/07/27/125766904/ee23df8517f3c3e3efc4145658269c06_5446750740417254342..png

创建[blog]/source/_data/creativity.yml，输入以下内容

1
- class_name: 开启创造力
2
  creativity_list:
3
    - name: Java
4
      color: "#fff"
5
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/26ba17ce013ecde9afc8b373e2fc0b9d_1804318147854602575.jpg
6
    - name: Docker
7
      color: "#57b6e6"
8
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/544b2d982fd5c4ede6630b29d86f3cae_7350393908531420887.png
9
    - name: Photoshop
10
      color: "#4082c3"
11
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/4ce1d081b9b37b06e3714bee95e58589_1613929877388832041.png
12
    - name: Node
13
      color: "#333"
14
      icon: https://npm.elemecdn.com/anzhiyu-blog@2.1.1/img/svg/node-logo.svg
15
    - name: Webpack
16
      color: "#2e3a41"
17
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/32dc115fbfd1340f919f0234725c6fb4_4060605986539473613.png
18
    - name: Pinia
19
      color: "#fff"
20
      icon: https://npm.elemecdn.com/anzhiyu-blog@2.0.8/img/svg/pinia-logo.svg
21
    - name: Python
22
      color: "#fff"
23
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/02c9c621414cc2ca41035d809a4154be_7912546659792951301.png
24
    - name: Vite
25
      color: "#937df7"
26
      icon: https://npm.elemecdn.com/anzhiyu-blog@2.0.8/img/svg/vite-logo.svg
27
    - name: Flutter
28
      color: "#4499e4"
29
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/b5aa93e0b61d8c9784cf76d14886ea46_4590392178423108088.png
30
    - name: Vue
31
      color: "#b8f0ae"
32
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/cf23526f451784ff137f161b8fe18d5a_692393069314581413.png
33
    - name: React
34
      color: "#222"
35
      icon: data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9Ii0xMS41IC0xMC4yMzE3NCAyMyAyMC40NjM0OCI+CiAgPHRpdGxlPlJlYWN0IExvZ288L3RpdGxlPgogIDxjaXJjbGUgY3g9IjAiIGN5PSIwIiByPSIyLjA1IiBmaWxsPSIjNjFkYWZiIi8+CiAgPGcgc3Ryb2tlPSIjNjFkYWZiIiBzdHJva2Utd2lkdGg9IjEiIGZpbGw9Im5vbmUiPgogICAgPGVsbGlwc2Ugcng9IjExIiByeT0iNC4yIi8+CiAgICA8ZWxsaXBzZSByeD0iMTEiIHJ5PSI0LjIiIHRyYW5zZm9ybT0icm90YXRlKDYwKSIvPgogICAgPGVsbGlwc2Ugcng9IjExIiByeT0iNC4yIiB0cmFuc2Zvcm09InJvdGF0ZSgxMjApIi8+CiAgPC9nPgo8L3N2Zz4K
36
    - name: CSS3
37
      color: "#2c51db"
38
      icon: https://upload-bbs.miyoushe.com/upload/2025/08/02/125766904/948767d87de7c5733b5f59b036d28b4b_3573026798828830876.png
39
    - name: JS
40
      color: "#f7cb4f"
41
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/06216e7fddb6704b57cb89be309443f9_7269407781142156006.png
42
    - name: HTML
43
      color: "#e9572b"
44
      icon: https://upload-bbs.miyoushe.com/upload/2025/08/02/125766904/f774c401c8bc2707e1df1323bdc9e423_1926035231499717029.png
45
    - name: Git
46
      color: "#df5b40"
47
      icon: https://upload-bbs.miyoushe.com/upload/2025/07/29/125766904/fcc0dbbfe206b4436097a8362d64b558_6981541002497327189.webp
48
    - name: Apifox
49
      color: "#e65164"
50
      icon: https://upload-bbs.miyoushe.com/upload/2025/08/02/125766904/b61bc7287d7f7f89bd30079c7f04360e_2465770520170903938.png

展开收起

此时可以看到首页顶部已经有技能点的轮播了。

技能点轮播

文字部分在主题配置文件中home_top配置项修改

配置 nav 顶栏左侧应用列表#

1
# nav左侧菜单
2
nav:
3
  enable: true
4
  menu:
5
    - title: 网页
6
      item:
7
        - name: 个人主页
8
          link: https://index.anheyu.com/
9
          icon: https://bu.dusays.com/2023/08/13/64d8c2748ef34.jpg
10
        - name: 博客
11
          link: https://hexo.anheyu.com/
12
          icon: https://bu.dusays.com/2023/07/23/64bc72c75319d.png
13
        - name: 安知鱼图床
14
          link: https://image.anheyu.com/
15
          icon: https://bu.dusays.com/2023/08/13/64d8c2653332e.ico
16
    - title: 项目
17
      item:
18
        - name: 安知鱼图床
19
          link: https://image.anheyu.com/
20
          icon: https://bu.dusays.com/2023/08/13/64d8c2653332e.ico

展开收起

字数统计#

要为 AnZhiYu 配上字数统计特性, 你需要如下几个步骤:

打开 hexo 工作目录

Terminal window

1
npm install hexo-wordcount --save
2
或者
3
yarn add hexo-wordcount

修改主题配置文件:

1
wordcount:
2
  enable: true
3
  post_wordcount: true
4
  min2read: true
5
  total_wordcount: true

网站验证#

如果需要搜索引擎收录网站，可能需要登录对应搜索引擎的管理平台进行提交。各自的验证码可从各自管理平台拿到

修改 主题配置文件

1
site_verification:
2
  # - name: google_site_verification
3
  #   content: xxxxxx
4
  # - name: baidu_site_verification
5
  #   content: xxxxxxx

搜索系统#

algolia本地搜索DocSearch

记得运行 hexo clean

使用 hexo-algoliasearch，请记得配置 fields 参数的 title, permalink 和 content

你需要安装 hexo-algoliasearch. 根据它的说明文档去做相应的配置。

修改主题配置文件

yaml

1
algolia_search:
2
  enable: true
3
  hits:
4
    per_page: 6

hexo 配置文件 _config.yml 添加以下内容

注意 algolia 搜索出来 URL 前缀为 hexo 配置文件_config.yml中的url配置。

yaml

1
# algolia搜索: https://github.com/LouisBarranqueiro/hexo-algoliasearch
2
algolia:
3
  appId: "xxxx"
4
  apiKey: "xxxx"
5
  adminApiKey: "xxxx"
6
  chunkSize: 5000
7
  indexName: "hexo"
8
  fields:
9
    - content:strip:truncate,0,200
10
    - excerpt:strip
11
    - gallery
12
    - permalink
13
    - photos
14
    - slug
15
    - tags
16
    - title

展开收起

数学公式#

hexo-renderer-pandoc（推荐）MathjaxKaTeXhexo-renderer-markdown-ithexo-renderer-markdown-it-plus

详情请见 https://www.yyyzyyyz.cn/posts/654d8712aff4/

分享#

只能选择一个分享服务商

sharejsaddtoany

如果你不知道 sharejs，看看它的説明。

修改 主题配置文件

1
sharejs:
2
  enable: true
3
  sites: facebook,twitter,wechat,weibo,qq #想要显示的内容

欢迎语配置#

在每次进入首页时根据当前时间弹出欢迎语，为 true 时必须配置 list。

1
# 欢迎语配置
2
greetingBox:
3
  enable: true #开启后必须配置下面的list对应的时间段，不然会出现小白条
4
  default: 晚上好👋
5
  list:
6
    - greeting: 晚安😴
7
      startTime: 0
8
      endTime: 5
9
    - greeting: 早上好鸭👋, 祝你一天好心情！
10
      startTime: 6
11
      endTime: 9
12
    - greeting: 上午好👋, 状态很好，鼓励一下～
13
      startTime: 10
14
      endTime: 10
15
    - greeting: 11点多啦, 在坚持一下就吃饭啦～
16
      startTime: 11
17
      endTime: 11
18
    - greeting: 午安👋, 宝贝
19
      startTime: 12
20
      endTime: 14
21
    - greeting: 🌈充实的一天辛苦啦！
22
      startTime: 14
23
      endTime: 18
24
    - greeting: 19点喽, 奖励一顿丰盛的大餐吧🍔。
25
      startTime: 19
26
      endTime: 19
27
    - greeting: 晚上好👋, 在属于自己的时间好好放松😌~
28
      startTime: 20
29
      endTime: 24

展开收起

欢迎语配置

博客快捷键#

1
# 快捷键配置
2
shortcutKey:
3
  enable: true
4
  delay: 100 # 所有键位延时触发而不是立即触发（包括shift，以解决和浏览器键位冲突问题）
5
  shiftDelay: 200 # shift按下延时多久开启

博客快捷键

无障碍优化#

1
# 无障碍优化（在首页按下「shift + ?」以查看效果）
2
accesskey:
3
  enable: true

无障碍优化

友情链接顶部相关配置#

1
# 友情链接顶部相关配置
2
linkPageTop:
3
  enable: true
4
  title: 与数百名博主无限进步
5
  # 添加博主友链的评论自定义格式
6
  addFriendPlaceholder: "昵称（请勿包含博客等字样）：\n网站地址（要求博客地址，请勿提交个人主页）：\n头像图片url（请提供尽可能清晰的图片，我会上传到我自己的图床）：\n描述：\n站点截图（可选）：\n"

缩略图后缀#

该配置用于优化缩略图，archive/tag/category 页面单独开启后缀，可以优化图像质量问题，注意开启后一定要保证你的图片本身可以支持链接后 ➕pageThumbnailSuffix 能够被访问。

1
# 缩略图后缀 archive/tag/category 页面单独开启后缀
2
pageThumbnailSuffix: "!page_thumbnail"

缩略图后缀

隐私协议弹窗#

该弹窗一个窗口会话只会弹出一次。

1
# 隐私协议弹窗
2
agreementPopup:
3
  enable: true
4
  url: /privacy

隐私协议弹窗

定制化的右键菜单#

开启rightClickMenu即可。

1
# 右键菜单
2
rightClickMenu:
3
  enable: true

右键菜单一般情况

右键菜单链接情况

动效控制#

1
# 动效
2
dynamicEffect:
3
  postTopWave: true # 文章顶部波浪效果
4
  postTopRollZoomInfo: true # 文章顶部滚动时缩放
5
  pageCommentsRollZoom: true # 非文章页面评论滚动时缩放显示（仅仅Twikoo生效）

文章顶部波浪效果

文章顶部滚动时缩放

非文章页面评论滚动时缩放显示

51A 统计#

可以配置 51A 统计与灵雀

配置后可在关于页面显示统计信息。

1
# 51a统计配置
2
LA:
3
  enable: true
4
  ck: Jp8wwGQpp21utaFQ
5
  LingQueMonitorID: Jp8ztDRrxmTf7LDj

警告

注意一定要开启数据挂件功能!!!

开启数据挂件

51A统计ck

灵雀LingQueMonitorID

页面卡片顶部气泡升起效果#

1
# 页面卡片顶部气泡升起效果
2
bubble:
3
  enable: false

页面卡片顶部气泡升起效果

深色模式粒子效果 canvas#

1
# 深色模式粒子效果canvas
2
universe:
3
  enable: true

深色模式粒子效果canvas

Important

额外配置

2025-01-23T12:32:13.000Z

额外配置 🚀#

Footer 设置#

since 是一个来展示你站点起始时间的选项。它位于页面的最底部。

1
## Footer Settings
2
## --------------------------------------
3
footer:
4
  owner:
5
    enable: true
6
    since: 2020
7
  custom_text:
8
  runtime:
9
    enable: true
10
    launch_time: 04/01/2021 00:00:00 # 网站上线时间
11
    work_img: https://npm.elemecdn.com/anzhiyu-blog@2.0.4/img/badge/安知鱼-上班摸鱼中.svg
12
    work_description: 距离月入25k也就还差一个大佬带我~
13
    offduty_img: https://npm.elemecdn.com/anzhiyu-blog@2.0.4/img/badge/安知鱼-下班啦.svg
14
    offduty_description: 下班了就该开开心心的玩耍，嘿嘿~
15
  # 徽标部分配置项 https://shields.io/
16
  # https://img.shields.io/badge/CDN-jsDelivr-orange?style=flat&logo=jsDelivr
17
  bdageitem:
18
    - link: https://hexo.io/ #徽标指向网站链接
19
      shields: https://npm.elemecdn.com/anzhiyu-blog@2.1.5/img/badge/Frame-Hexo.svg #徽标API
20
      message: 博客框架为Hexo_v5.4.0 #徽标提示语
21
    - link: https://hexo.anheyu.com/
22
      shields: https://pan.anheyu.com/d/anzhiyu/svg/Theme-AnZhiYu-2E67D3.svg
23
      message: 本站使用AnZhiYu主题
24
    - link: https://www.dogecloud.com/
25
      shields: https://npm.elemecdn.com/anzhiyu-blog@2.2.0/img/badge/CDN-多吉云-3693F3.svg
26
      message: 本站使用多吉云为静态资源提供CDN加速
27
    - link: https://github.com/
28
      shields: https://npm.elemecdn.com/anzhiyu-blog@2.1.5/img/badge/Source-Github.svg
29
      message: 本站项目由Github托管
30
    - link: http://creativecommons.org/licenses/by-nc-sa/4.0/
31
      shields: https://npm.elemecdn.com/anzhiyu-blog@2.2.0/img/badge/Copyright-BY-NC-SA.svg
32
      message: 本站采用知识共享署名-非商业性使用-相同方式共享4.0国际许可协议进行许可

展开收起

参数	解释
owner	页脚网站所有者@2020-当前年份
owner.enable	页脚网站所有者是否启用
owner.since	页脚年份，控制台中打印的运行时间也来自这里
runtime	运行时间
runtime.enable	运行时间是否启用
runtime.launch_time	网站上线时间
runtime.work_img	页脚上班时间的徽标
runtime.work_description	页脚上班时间的 title 描述
runtime.offduty_img	页脚下班时间的徽标
runtime.offduty_description	页脚下班时间的 title 描述
bdageitem	徽标配置项
bdageitem.link	徽标配置链接
bdageitem.shields	徽标配置徽标
bdageitem.message	徽标配置徽标 title

页脚

页脚你好自动定义文字

侧边栏设置#

可自行决定哪个项目需要显示，可决定位置，也可以设置不显示侧边栏。

修改 主题配置文件

1
## aside (侧边栏)
2
## --------------------------------------
3

4
aside:
5
  enable: true
6
  hide: false
7
  button: true
8
  mobile: true # display on mobile
9
  position: right # left or right
10
  display: # 控制对应详情页面是否显示侧边栏
11
    archive: true
12
    tag: true
13
    category:  true
14
  card_author:
15
    enable: true
16
    description: 这有关于产品、设计、开发相关的问题和看法，还有文章翻译和分享。
相信你可以在这里找到对你有用的知识和教程。
17
    name_link: /about
18
  card_announcement:
19
    enable: false
20
    content: 欢迎来看我的博客鸭~
21
  card_weixin:
22
    enable: true
23
    face: https://img02.anheyu.com/adminuploads/1/2022/09/11/631ddb7c9b250.png
24
    backFace: https://img02.anheyu.com/adminuploads/1/2022/09/11/631ddeb0900b7.png
25
  card_recent_post:
26
    enable: true
27
    limit: 5 # if set 0 will show all
28
    sort: date # date or updated
29
    sort_order: # Don't modify the setting unless you know how it works
30
  card_category:
31
    enable: false
32
    limit: 8 # if set 0 will show all
33
    expand: none # none/true/false
34
    sort_order: # Don't modify the setting unless you know how it works
35
  card_tags:
36
    enable: true
37
    limit: 40 # if set 0 will show all
38
    color: false
39
    sort_order: # Don't modify the setting unless you know how it works
40
    highlightTags:
41
      - Hexo
42
      - 前端
43
  card_archives:
44
    enable: true
45
    type: monthly # yearly or monthly
46
    format: MMMM YYYY # eg: YYYY年MM月
47
    order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending
48
    limit: 8 # if set 0 will show all
49
    sort_order: # Don't modify the setting unless you know how it works
50
  card_webinfo:
51
    enable: true
52
    post_count: true
53
    last_push_date: false
54
    sort_order: # Don't modify the setting unless you know how it works

展开收起

其中 card_weixin 可以控制微信公众号的图片，face为翻转前的图片，backFace为翻转后的图片。

访问人数 busuanzi#

访问 busuanzi 的官方网站查看更多的介绍。

修改 主题配置文件

1
busuanzi:
2
  site_uv: true
3
  site_pv: true
4
  page_pv: true

如果需要修改 busuanzi 的 CDN 链接，可通过主题配置文件的 CDN 中的 option 进行修改

1
CDN:
2
  option:
3
    busuanzi: xxxxxxxxx

运行时间#

网页已运行时间

修改 主题配置文件

1
## Time difference between publish date and now (网页运行时间)
2
## Formal: Month/Day/Year Time or Year/Month/Day Time
3
runtimeshow:
4
  enable: true
5
  publish_date: 4/1/2021 00:00:00

运行时间

右下角按钮#

简繁转换#

简体繁体互换

右下角会有简繁转换按钮。

修改 主题配置文件

1
translate:
2
  enable: true
3
  # 默认按钮显示文字(网站是简体，应设置为'default: 繁')
4
  default: 简
5
  #网站默认语言，1: 繁体中文, 2: 简体中文
6
  defaultEncoding: 1
7
  #延迟时间,若不在前, 要设定延迟翻译时间, 如100表示100ms,默认为0
8
  translateDelay: 0
9
  #当文字是简体时，按钮显示的文字
10
  msgToTraditionalChinese: "繁"
11
  #当文字是繁体时，按钮显示的文字
12
  msgToSimplifiedChinese: "简"

简体

简体

繁体

繁体

阅读模式#

阅读模式下会去掉除文章外的内容，避免干扰阅读。

只会出现在文章页面，右下角会有阅读模式按钮。

修改 主题配置文件

1
readmode: true

阅读模式

夜间模式#

右下角会有夜间模式按钮

修改 主题配置文件

1
## dark mode
2
darkmode:
3
  enable: true
4
  # Toggle Button to switch dark/light mode
5
  button: true
6
  # Switch dark/light mode automatically (自动切换 dark mode和 light mode)
7
  # autoChangeMode: 1  Following System Settings, if the system doesn't support dark mode, it will switch dark mode between 6 pm to 6 am
8
  # autoChangeMode: 2  Switch dark mode between 6 pm to 6 am
9
  # autoChangeMode: false
10
  autoChangeMode: 1
11
  # Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18
12
  start: # 8
13
  end: # 22

参数	解释
button	是否在右下角显示日夜模式切换按钮
autoChangeMode	自动切换的模式
autoChangeMode	autoChangeMode: 1 跟随系统而变化，不支持的浏览器/系统将按照时间 start 到 end 之间切换为 light mode autoChangeMode: 2 只按照时间 start 到 end 之间切换为 light mode ,其余时间为 dark mode autoChangeMode: false 取消自动切换
start	light mode 的开始时间
end	light mode 的结束时间

按钮排序#

1
## Don't modify the following settings unless you know how they work (非必要请不要修改 )
2
## Choose: readmode,translate,darkmode,hideAside,toc,chat,comment
3
## Don't repeat 不要重复
4
rightside_item_order:
5
  enable: false
6
  hide: # readmode,translate,darkmode,hideAside
7
  show: # toc,chat,comment

短标签 Tag Plugins#

TIP 短标签是 Hexo 独有的功能，并不是标准的 Markdown 格式。以下的写法，只适用于 AnZhiYu 主题，用在其它主题上不会有效果，甚至可能会报错。使用前请留意

Warning

短标签虽然能为主题带来一些额外的功能和 UI 方面的强化，但是，短标签也有明显的限制，使用时请留意。

只需要将标签写在 md 文件内即可使用，详细写法请阅读安知鱼主题标签 Tag Plugins 查看

评论弹幕#

评论弹幕仅支持 Twikoo。

token 在你博客的控制台获取，打开浏览器开发者工具，找到本地存储空间，找到键名为twikoo-access-token的内容，将值复制下来填写即可，本方法仅限 server 部署，其他部署方案请自行查看如何获取 token。

token获取

1
## 留言弹幕配置
2
comment_barrage_config:
3
  enable: true
4
  # 同时最多显示弹幕数
5
  maxBarrage: 1
6
  # 弹幕显示间隔时间ms
7
  barrageTime: 8000
8
  # token
9
  accessToken: "xxxxxx"
10
  # 博主邮箱md5值
11
  mailMd5: "xxxxxxxxxx"

分析统计#

百度统计#

登录百度统计的官方网站
找到你百度统计的统计代码

修改 主题配置文件

1
baidu_analytics: 你的代码

谷歌分析#

登录谷歌分析的官方网站
找到你的谷歌分析的跟踪 ID

谷歌分析

修改 主题配置文件

1
google_analytics: 你的代码 # 通常以`UA-`打头

Cloudflare#

登录 Cloudflare 分析的官方网站
找到 JavaScript 程式码片段
找到你的 token
修改 主题配置文件

1
## Cloudflare Analytics
2
## https://www.cloudflare.com/zh-tw/web-analytics/
3
cloudflare_analytics:

Microsoft Clarity#

登录 Clarity 的官方网站
创建 PROJECT
找到你的 ID

修改 主题配置文件

1
## Microsoft Clarity
2
## https://clarity.microsoft.com/
3
microsoft_clarity:

广告#

谷歌广告#

主题已集成谷歌广告（自动广告）

修改 主题配置文件

1
google_adsense:
2
  enable: true
3
  auto_ads: true
4
  js: https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js
5
  client: # 填入个人识别码
6
  enable_page_level_ads: true

手动广告配置#

主题预留了三个位置可供插入广告，分别为主页文章(每三篇文章出现广告)/aside 公告之后/文章页打赏之后。把 html 代码填写到对应的位置

修改 主题配置文件

1
ad:
2
  index:
3
  aside:
4
  post:

例如:

1
index:

页面加载动画#

当进入网页时，因为加载速度的问题，可能会导致 top_img 图片出现断层显示，或者网页加载不全而出现等待时间，开启 preloader 后，会显示加载动画，等页面加载完，加载动画会消失。

主题支持 pace.js 的加载动画，具体可查看 pace.js

修改 主题配置文件，其中avatar可以自定义加载时的头像

1
## Loading Animation (加载动画)
2
preloader:
3
  enable: true
4
  # source
5
  # 1. fullpage-loading
6
  # 2. pace (progress bar)
7
  # else all
8
  source: 3
9
  # pace theme (see https://codebyzach.github.io/pace/)
10
  pace_css_url:
11
  avatar: # 自定义头像

图片大图查看模式#

Warning

如果你并不想为某张图片添加大图查看模式，你可以使用 html 格式引用图片，并为图片添加 no-lightbox class 名。

修改 主题配置文件

Pjax#

当用户点击链接，通过 ajax 更新页面需要变化的部分，然后使用 HTML5 的 pushState 修改浏览器的 URL 地址。

这样可以不用重复加载相同的资源（css/js），从而提升网页的加载速度。

1
## Pjax [Beta]
2
## It may contain bugs and unstable, give feedback when you find the bugs.
3
## https://github.com/MoOx/pjax
4
pjax:
5
  enable: true
6
  exclude:
7
    - /music/
8
    - /no-pjax/

TIP 对于一些第三方插件，有些并不支持 pjax 。你可以把网页加入到 exclude 里，这个网页会被 pjax 排除在外。点击该网页会重新加载网站

使用 pjax 后，一些自己 DIY 的 js 可能会无效，跳转页面时需要重新调用，请参考Pjax 文档

使用 pjax 后，一些个别页面加载的 js/css，将会改为所有页面都加载

Warning

主题默认开启 Pjax，大量服务依赖于 pjax，关闭可能会造成破坏性问题。主题对 pjax 做了深度适配，关闭可能会造成严重的后果，比如某些链接无法跳转。

安知鱼主题的的 Pjax 目前仍有一些问题，请留意

使用谷歌广告可能会报错（例如自动广告）如果你在使用中发现问题，欢迎反馈 Bugs

Snackbar 弹窗#

Snackbar 弹窗,根据自己爱好开启

修改 主题配置文件

1
## Snackbar 弹窗
2
## https://github.com/polonel/SnackBar
3
## position 弹窗位置
4
## 可选 top-left / top-center / top-right / bottom-left / bottom-center / bottom-right
5
snackbar:
6
  enable: true
7
  position: bottom-left
8
  bg_light: "#49b1f5" #light mode时弹窗背景
9
  bg_dark: "#2d3035" #dark mode时弹窗背景

Pangu#

如果你跟我一样，每次看到网页上的中文字和英文、数字、符号挤在一块，就会坐立难安，忍不住想在它们之间加个空格。这个外挂正是你在网路世界走跳所需要的东西，它会自动替你在网页中所有的中文字和半形的英文、数字、符号之间插入空白。

修改 主题配置文件

1
## https://github.com/vinta/pangu.js
2
## Insert a space between Chinese character and English character (中英文之间添加空格)
3
pangu:
4
  enable: false
5
  field: post # site/post

field只支持两个参数，post(只在文章页生效)和site(全站生效)

PWA#

PWA 是 web 优化的一种手段，主题做了一定的适配，但是依然需要进行配置。要为 AnZhiYu 配上 PWA 特性, 你可以进行选择以下两种方式来进行适配，hexo-offline适合初学者，hexo-swpp适合已经对service worker有一定解决问题能力的进阶使用。

hexo-offline#

打开 hexo 工作目录
npm install hexo-offline --save 或者 yarn add hexo-offline
在根目录创建 hexo-offline.config.cjs 文件，并增加以下内容。

1
// offline config passed to workbox-build.
2
module.exports = {
3
  // 静态文件合集，如果你的站点使用了例如 webp 格式的文件，请将文件类型添加进去。
4
  globPatterns: ["404.html", "css/index.css"],
5
  globDirectory: "public",
6
  swDest: "public/service-worker.js",
7
  maximumFileSizeToCacheInBytes: 10485760, // 缓存的最大文件大小，以字节为单位。
8
  skipWaiting: true,
9
  clientsClaim: true,
10
  runtimeCaching: [
11
    // 如果你需要加载 CDN 资源，请配置该选项，如果没有，可以不配置。
12
    // CDNs - should be CacheFirst, since they should be used specific versions so should not change
13
    {
14
      urlPattern: /^https:\/\/npm\.elemecdn\.com\/anzhiyu-blog/, // 缓存elmentcdn
15
      handler: "CacheFirst",
16
    },
17
  ],
18
  manifestTransforms: [
19
    async (manifestEntries, compilation) => {
20
      const timestamp = new Date().toISOString().replace(/[-:.TZ]/g, ""); // 获取当前时间戳
21
      manifestEntries.push(
22
        {
23
          url: "/",
24
          revision: `index-${timestamp}`,
25
        },
26
        {
27
          url: "music/",
28
          revision: `music-${timestamp}`,
29
        },
30
        {
31
          url: "about/",
32
          revision: `about-${timestamp}`,
33
        }
34
      );
35
      return { manifest: manifestEntries };
36
    },
37
  ],
38
};

展开收起

更多内容请查看 hexo-offline 的官方文档

在主题配置文件中开启 pwa 选项。

1
## PWA
2
## See https://github.com/JLHwung/hexo-offline
3
## ---------------
4
pwa:
5
  enable: true
6
  startup_image_enable: true
7
  manifest: /manifest.json
8
  theme_color: var(--anzhiyu-main)
9
  mask_icon: /img/siteicon/apple-icon-180.png
10
  apple_touch_icon: /img/siteicon/apple-icon-180.png
11
  bookmark_icon: /img/siteicon/apple-icon-180.png
12
  favicon_32_32: /img/siteicon/32.png
13
  favicon_16_16: /img/siteicon/16.png

在创建source/目录中创建manifest.json文件。

1
{
2
  "name": "安知鱼`Blog",
3
  "short_name": "安知鱼",
4
  "theme_color": "#3b70fc",
5
  "background_color": "#3b70fc",
6
  "display": "fullscreen",
7
  "scope": "/",
8
  "start_url": "/",
9
  "id": "/",
10
  "icons": [
11
    {
12
      "src": "img/siteicon/manifest-icon-192.maskable.png",
13
      "sizes": "192x192",
14
      "type": "image/png",
15
      "purpose": "any"
16
    },
17
    {
18
      "src": "img/siteicon/manifest-icon-192.maskable.png",
19
      "sizes": "192x192",
20
      "type": "image/png",
21
      "purpose": "maskable"
22
    },
23
    {
24
      "src": "img/siteicon/manifest-icon-512.maskable.png",
25
      "sizes": "512x512",
26
      "type": "image/png",
27
      "purpose": "any"
28
    },
29
    {
30
      "src": "img/siteicon/manifest-icon-512.maskable.png",
31
      "sizes": "512x512",
32
      "type": "image/png",
33
      "purpose": "maskable"
34
    }
35
  ],
36
  "splash_pages": null
37
}

展开收起

你也可以通过 Web App Manifestopen 快速创建manifest.json。（Web App Manifest 要求至少包含一个 512*512 像素的图标）

可以通过Chrome插件Lighthouse检查 PWA 配置是否生效以及配置是否正确。

打开博客页面
启动Lighthouse插件 (Lighthouse 插件要求至少包含一个 512*512 像素的图标)

关于 PWA（渐进式增强 Web 应用）的更多内容请参考 Google Tools for Web Developersopen

生成 pwa 启动图

安装 pwa-asset-generator，执行以下命令

Terminal window

1
npm install pwa-asset-generator

hexo 根目录执行hexo g后执行以下命令

Terminal window

1
npx pwa-asset-generator ./public/img/512.png ./public/img/siteicon --padding "calc(50vh - 20%) calc(50vw - 40%)" -s false -h true

这条命令会使用themes/source/img/512.png这张图片来生成 siteicon 到目录/public/img/siteicon中，由于hexo cl会清除/public目录中的文件，所以每次hexo d之前都需要执行，如果不想每次hexo d之前都执行的话，可以将主题中的themes/source/img/512.png图片复制移动到根目录``/source/img中，然后将生成后的/public/img/siteicon文件夹复制到根目录``/source/img中，这样根目录``/source/img中就会一直有siteicon，以后执行hexo g时，也会将siteicon生成到public目录中。

hexo-swpp#

主题版本大于 1.5.2 支持，这种加载办法为极其迅速，由 sw 控制其缓存，实现原理以及配置请查看以下三篇文章

hexo-swpp

swpp-backends

Swpp Backends 官方文档

配置方法：

安装 hexo-swpp 插件和 swpp-backends，在博客根目录执行

Terminal window

1
npm install hexo-swpp --save
2
npm install swpp-backends --save

在主题配置文件中开启 pwa 选项。

1
## PWA
2
## See https://github.com/JLHwung/hexo-offline
3
## ---------------
4
pwa:
5
enable: true
6
startup_image_enable: true
7
manifest: /manifest.json
8
theme_color: var(--anzhiyu-main)
9
mask_icon: /img/siteicon/apple-icon-180.png
10
apple_touch_icon: /img/siteicon/apple-icon-180.png
11
bookmark_icon: /img/siteicon/apple-icon-180.png
12
favicon_32_32: /img/siteicon/32.png
13
favicon_16_16: /img/siteicon/16.png

在 hexo 的配置文件中添加如下内容即可启用插件：

1
swpp:
2
## 是否启用插件
3
enable: true
4
## 是否在发布前自动执行脚本
5
## auto_exec: true

在创建source/目录中创建manifest.json文件。

1
{
2
"name": "安知鱼`Blog",
3
"short_name": "安知鱼",
4
"theme_color": "#3b70fc",
5
"background_color": "#3b70fc",
6
"display": "fullscreen",
7
"scope": "/",
8
"start_url": "/",
9
"id": "/",
10
"icons": [
11
{
12
"src": "img/siteicon/manifest-icon-192.maskable.png",
13
"sizes": "192x192",
14
"type": "image/png",
15
"purpose": "any"
16
},
17
{
18
"src": "img/siteicon/manifest-icon-192.maskable.png",
19
"sizes": "192x192",
20
"type": "image/png",
21
"purpose": "maskable"
22
},
23
{
24
"src": "img/siteicon/manifest-icon-512.maskable.png",
25
"sizes": "512x512",
26
"type": "image/png",
27
"purpose": "any"
28
},
29
{
30
"src": "img/siteicon/manifest-icon-512.maskable.png",
31
"sizes": "512x512",
32
"type": "image/png",
33
"purpose": "maskable"
34
}
35
],
36
"splash_pages": null
37
}

展开收起

你也可以通过 Web App Manifestopen 快速创建manifest.json。（Web App Manifest 要求至少包含一个 512*512 像素的图标）

可以通过Chrome插件Lighthouse检查 PWA 配置是否生效以及配置是否正确。打开博客页面启动Lighthouse插件 (Lighthouse 插件要求至少包含一个 512*512 像素的图标) 关于 PWA（渐进式增强 Web 应用）的更多内容请参考 Google Tools for Web Developersopen
生成 pwa 启动图安装pwa-asset-generator

Terminal window

1
npm install pwa-asset-generator

hexo 根目录执行hexo g然后执行

Terminal window

1
npx pwa-asset-generator ./public/img/512.png ./public/img/siteicon --padding "calc(50vh - 20%) calc(50vw - 40%)" -s false -h true

这条命令会使用themes/anzhiyu/source/img/512.png这张图片来生成 siteicon 到目录/public/img/siteicon中，由于hexo cl会清除/public目录中的文件，所以每次hexo d之前都需要执行，如果不想每次hexo d之前都执行的话，可以将主题中的themes/anzhiyu/source/img/512.png图片复制移动到根目录``/source/img中，然后将生成后的/public/img/siteicon文件夹复制到根目录``/source/img中，这样根目录``/source/img中就会一直有siteicon，以后执行hexo g时，也会将siteicon生成到public目录中。

在 hexo g 以后执行一次 hexo swpp 命令如果你的网站使用了 CDN 且启用了 CDN 端缓存，请务必将 CDN 缓存时间调整至最大值，然后每次更新网页内容后手动刷新 CDN 缓存。因为本插件的更新方案要求update.json更新时，其它所有需要更新的资源均已更新，否则客户端拉取时会误以为拉取到了最新的内容，从而导致部分资源“错过”更新。简而言之，就是update.json必须与需要缓存的资源共享同样的 CDN 缓存周期，但是目前市面上我知道的 CDN 无法做到这一点，所以只能从下列选项中二选一

把所有资源的 CDN 缓存时间拉满，每次更新网站时刷新 CDN 缓存
CDN 不缓存所有需要在客户端缓存的资源

Netlify 构建后自动刷新 CDN 缓存的教程见：《全自动博客部署方案》请务必注意 CDN 缓存的问题！！！默认主题将只缓存 404 和 index.css 如果你需要配置自己的缓存策略，请在博客根目录新建sw-rules.js 请注意 ⚠️ 定期或不定期检查 hexo swpp 是否存在更新，以及查看更新日志对配置做出最新的更改

Warning

主题默认内置了一份 sw-rules.js 规则，位于themes/anzhiyu/sw-rules.js可以开箱即用，如需自定义缓存规则可以复制该文件至 hexo 根目录然后修改根目录的 sw-rules.js。

安知鱼主题适配 hexo-swpp3.2+，swpp-backends2.0+更多内容请参考 Swpp Backends 官方文档 hexo-swpp swpp-backends 解剖 SW 原理暨博主 SW 实现小白也能用的 SW 构建插件

Open Graph#

在 head 里增加一些 meta 资料，例如缩略图、标题、时间等等。当你分享网页到一些平台时，平台会读取 Open Graph 的内容，展示缩略图，标题等等信息。

修改 主题配置文件

1
## Open graph meta tags
2
## https://developers.facebook.com/docs/sharing/webmasters/
3
Open_Graph_meta:
4
  enable: true
5
  option:
6
    # twitter_card:
7
    # twitter_image:
8
    # twitter_id:
9
    # twitter_site:
10
    # google_plus:
11
    # fb_admins:
12
    # fb_app_id:

CSS 前缀#

有些 CSS 并不是所有浏览器都支持，需要增加对应的前缀才会生效。

开启 css_prefix 后，会自动为一些 CSS 增加前缀。（会增加 20%的体积）

修改 主题配置文件

1
## Add the vendor prefixes to ensure compatibility
2
css_prefix: true

Inject#

如想添加额外的 js/css/meta 等等东西，可以在 Inject 里添加，支持添加到 head(标签之前)和 bottom(标签之前)。

请注意：以标准的 html 格式添加内容

1
inject:
2
  head:
3
    - 
4
  bottom:
5
    -

留意: 如果你的网站根目录不是’/‘,使用本地图片时，需加上你的根目录。

例如：网站是 https://yoursite.com/blog,引用css/xx.css，则设置为

CDN#

配置文件中最后一部分 CDN，里面是主题所引用到的文件，可自行配置 CDN。（非必要请勿修改，配置后请确认链接是否能访问）

1
## CDN
2
## Don't modify the following settings unless you know how they work
3
## 非必要请不要修改
4
CDN:
5
  # The CDN provider of internal scripts (主题内部 js 的 cdn 配置)
6
  # option: local/elemecdn/jsdelivr/unpkg/cdnjs/custom
7
  # Dev version can only choose. ( dev版的主题只能设置为 local )
8
  internal_provider: cbd
9

10
  # The CDN provider of third party scripts (第三方 js 的 cdn 配置)
11
  # option: elemecdn/jsdelivr/unpkg/cdnjs/custom
12
  third_party_provider: cbd
13

14
  # Add version number to CDN, true or false
15
  version: true
16

17
  # Custom format
18
  # For example: https://cdn.staticfile.org/${cdnjs_name}/${version}/${min_cdnjs_file}
19
  custom_format: # https://npm.elemecdn.com/${name}@latest/${file}
20

21
  option:
22
    # main_css:
23
    # main:
24
    # utils:
25
    # translate:
26
    # random_friends_post_js:
27
    # right_click_menu_js:
28
    # comment_barrage_js:
29
    # local_search:
30
    # algolia_js:
31
    # algolia_search:
32
    # instantsearch:
33
    # pjax:
34
    # blueimp_md5:
35
    # valine:
36
    # twikoo:
37
    # waline_js:
38
    # waline_css:
39
    # sharejs:
40
    # sharejs_css:
41
    # mathjax:
42
    # katex:
43
    # katex_copytex:
44
    # mermaid:
45
    # canvas_ribbon:
46
    # canvas_fluttering_ribbon:
47
    # canvas_nest:
48
    # lazyload:
49
    # instantpage:
50
    # typed:
51
    # pangu:
52
    # fancybox_css:
53
    # fancybox:
54
    # medium_zoom:
55
    # snackbar_css:
56
    # snackbar:
57
    # activate_power_mode:
58
    # fireworks:
59
    # click_heart:
60
    # ClickShowText:
61
    # fontawesome:
62
    # flickr_justified_gallery_js:
63
    # flickr_justified_gallery_css:
64
    # aplayer_css:
65
    # aplayer_js:
66
    # meting_js:
67
    # meting_api:
68
    # prismjs_js:
69
    # prismjs_lineNumber_js:
70
    # prismjs_autoloader:
71
    # artalk_js:
72
    # artalk_css:
73
    # pace_js:
74
    # pace_default_css:
75
    # countup_js:
76
    # gsap_js:
77
    # busuanzi:
78
    # rightmenu:
79
    # waterfall:
80
    # ali_iconfont_css:
81
    # accesskey_js:

展开收起

参数	解释
internal_provider	主题内部文件
可选 local/jsdelivr/unpkg/cdnjs/custom
lcoal 为本地加载，custom 为自定义格式，需配置 `custom_format`
注意: 如果使用的是 Dev 版，只能设置为 local
third_party_provider	第三方文件
可选 local/jsdelivr/unpkg/cdnjs/custom
lcoal 为本地加载，custom 为自定义格式，需配置 custom_format
注意: 如果你选择 local 则需要自行将文件都下载至本地，并修改对应的选项，否则会报错。
version	true/false 为 cdn 加上指定版本号
custom_format	自定义格式
option	你可以在这里更换部分文件,会覆盖原有的配置

version#

如需修改版本号，可修改主题目录的 ‘plugins.yml’ 中对应插件的 version

请确保你修改的版本号，你所使用的 cdn 有收录

custom_format#

提供以下参数

参数	解释
name	npm 上的包名
file	npm 上的文件路径
min_file	cdnjs 上的包名
cdnjs_file	cdnjs 上的文件路径
min_cdnjs_file	cdnjs 上的文件路径（压缩过的文件）
version	插件版本号

部分可用的第三方 CDN 列表

请确保你选择的 CDN 有收录主题使用的第三方插件

提供商	格式	备注
Staticfile（七牛云）	[https://cdn.staticfile.org/cdnjs_name/{cdnjs\_name}/cdnjs_name/{version}/min_cdnjs_file](https://cdn.staticfile.org/{min\_cdnjs\_file}](https://cdn.staticfile.org/min_cdnjs_file](https://cdn.staticfile.org/%7Bcdnjs_name%7D/%7Bversion%7D/%7Bmin_cdnjs_file%7D)	同步 cdnjs
BootCDN	[https://cdn.bootcdn.net/ajax/libs/cdnjs_name/{cdnjs\_name}/cdnjs_name/{version}/min_cdnjs_file](https://cdn.bootcdn.net/ajax/libs/{min\_cdnjs\_file}](https://cdn.bootcdn.net/ajax/libs/min_cdnjs_file](https://cdn.bootcdn.net/ajax/libs/%7Bcdnjs_name%7D/%7Bversion%7D/%7Bmin_cdnjs_file%7D)	同步 cdnjs
Baomitu（360）	最新版本： https://lib.baomitu.com/cdnjs_name/latest/{cdnjs\_name}/latest/cdnjs_name/latest/{min_cdnjs_file}
指定版本： [https://lib.baomitu.com/cdnjs_name/{cdnjs\_name}/cdnjs_name/{version}/min_cdnjs_file](https://lib.baomitu.com/{min\_cdnjs\_file}](https://lib.baomitu.com/min_cdnjs_file](https://lib.baomitu.com/%7Bcdnjs_name%7D/%7Bversion%7D/%7Bmin_cdnjs_file%7D)	同步 cdnjs
Elemecdn	最新版本： https://npm.elemecdn.com/name@latest/{name}@latest/name@latest/{file}
指定版本： [https://npm.elemecdn.com/name@{name}@name@{version}/file](https://npm.elemecdn.com/{file}](https://npm.elemecdn.com/file](https://npm.elemecdn.com/%7Bname%7D@%7Bversion%7D/%7Bfile%7D)	同步 npm

相册页面配置

2025-01-23T12:32:13.000Z

相册页面配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page album

你会找到 source/album/index.md 这个文件
修改这个文件：记得添加 type: "album"

1
---
2
title: 相册集
3
date: 2022-10-23 15:57:51
4
aside: false
5
top_img: false
6
type: "album"
7
---

主题配置文件中开启menu中我的和相册集的注释，注意缩进！！！

1
menu:
2
# 文章:
3
#   隧道: /archives/ || icon-box-archive
4
#   分类: /categories/ || icon-shapes
5
#   标签: /tags/ || icon-tags
6

7
友链:
8
友人帐: /link/ || icon-link
9
#   朋友圈: /fcircle/ || icon-artstation
10
#   留言板: /comments/ || icon-envelope
11

12
我的:
13
音乐馆: /music/ || icon-music
14
#   追番页: /bangumis/ || icon-bilibili1
15
相册集: /album/ || icon-images
16
#   小空调: /air-conditioner/ || icon-fan
17

18
关于:
19
#   关于本人: /about/ || icon-zhifeiji
20
闲言碎语: /essay/ || icon-lightbulb
21
#   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

新建文件[blog]\source\_data\album.yml,没有_data文件夹的话也请自己新建。打开[blog]\source\_data\album.yml，输入：

1
- class_name: 世界各地夕阳与风景
2
    path_name: /wordScenery
3
    type: 2
4
    description: 因为到不了世界各地，所以请网友们发来了各地的夕阳与风景🌇。
5
    cover: https://upload-bbs.miyoushe.com/upload/2025/06/13/125766904/2cf2b6aea07bba089d0d17c4fea72d1b_5366629137934368264.png
6
    top_background: https://bu.dusays.com/2023/06/30/649e546ada7dd.webp
7
    rowHeight: 220
8
    limit: 10
9
    lazyload: true
10
    btnLazyload: false
11
    url: false
12
    top_link: /album
13
    top_btn_text: 返回
14
    album_list:
15
        - date: 2022/10/26 01:00:00
16
        content: 湘潭的一角。
17
        address: 湖南湘潭
18
        from: 再吃一口就减肥
19
        image:
20
            - https://bu.dusays.com/2023/04/09/64329399db122.webp
21
        - date: 2022-10-25
22
        content: 洛阳暴雨后的天空。
23
        address: 河南洛阳
24
        from: 紫菜卷
25
        image:
26
            - https://bu.dusays.com/2023/04/09/64329399db122.webp
27
            - https://bu.dusays.com/2023/04/09/64329399db2e1.webp
28

29
- class_name: 我的日常
30
    path_name: /dailyPhoto
31
    type: 1
32
    description: 这里存放的是有关我自己的一些沙雕生活与有趣的事情。
33
    top_link: /album
34
    top_btn_text: 返回
35
    top_background: https://bu.dusays.com/2023/04/09/64329399cea5a.webp
36
    cover: https://bu.dusays.com/2023/04/09/64329399cea5a.webp
37
    album_list:
38
        - date: 2022-10-24
39
        content: 老妹的画
40
        image:
41
            - https://bu.dusays.com/2023/04/09/643293997b92b.jpeg

展开收起

参数	备选值/类型	解释
class_name	string	【必须】页面类
path_name	url	【必须】当前相册路径
type	number	【必须】当前相册页面样式类型
description	string	【必须】当前相册描述
cover	url	【必须】当前相册 cover 图片
rowHeight	number	【可选】仅当 type 为 2 时有效，当前相册 rowHeight
limit	number	【可选】仅当 type 为 2 时有效，当前相册一次懒加载的数量
lazyload	boolean	【可选】仅当 type 为 2 时有效，当前相册 lazyload 是否开启懒加载，默认懒加载为滚动懒加载，type 为 1 时懒加载不可关闭。
btnLazyload	boolean	【可选】仅当 type 为 2 且 lazyload 开启时有效，当前相册 lazyload 懒加载的方式，默认为滚动懒加载，开启本选项后为按钮点击懒加载。
album_list	list	【必须】当前相册内图片列表
url	url	【可选】仅当 type 为 2 时有效，可以加载远程的 json 数据。
album_list.date	date	【必须】当前图片创建时间
album_list.content	string	【必须】当前图片描述内容
album_list.image	list	【必须】当前图片集，可以多张
album_list.from	string	【可选】当前图片的创建人，未填写则不显示
album_list.address	string	【必须】当前图片地址

Warning

注意示例数据中的图片不保证可用性。

由于相册页面需要很多的 page，所以在写数据的时候自行写入路径path_name，示例数据中有两个path_name，所以需要再创建两个页面

注意新建的页面必须与path_name一致。

Terminal window

1
hexo new page dailyPhoto
2
hexo new page wordScenery

你会找到 source/dailyPhoto/index.md 和source/wordScenery/index.md两个文件，这两个为相册集详情页

然后内容为以下内容, 需在详情页加上type: "album_detail"

1
---
2
title: 日常生活
3
date: 2022-10-23 15:57:51
4
aside: false
5
top_img: false
6
type: "album_detail"
7
---

1
---
2
title: 世界各地风景
3
date: 2022-10-23 15:57:51
4
aside: false
5
top_img: false
6
type: "album_detail"
7
---

远程加载json示例数据

1
[
2
  {
3
    "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0556.jpg",
4
    "alt": "IMG_0556.jpg",
5
    "title": "这是title"
6
  },
7
  {
8
    "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0472.jpg",
9
    "alt": "IMG_0472.jpg"
10
  },
11
  {
12
    "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0453.jpg",
13
    "alt": ""
14
  },
15
  {
16
    "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0931.jpg",
17
    "alt": ""
18
  }
19
]

展开收起

相册页

分类页配置

2025-01-23T12:32:13.000Z

分类页配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page categories

你会找到 source/categories/index.md 这个文件
修改这个文件：记得添加 type: "categories"

1
---
2
title: 分类
3
date: 2022-02-23 17:56:00
4
aside: false
5
top_img: false
6
type: "categories"
7
---

朋友圈页面配置

2025-01-23T12:32:13.000Z

朋友圈页面配置#

在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page fcircle

打开[blog]\source\fcircle\index.md,添加一行type: 'fcircle':

1
---
2
title: 朋友圈
3
date: 2022-11-21 17:06:17
4
comments: false
5
aside: false
6
top_img: false
7
type: "fcircle"
8
---

主题配置文件中开启menu中友链和朋友圈的注释，导航栏朋友圈，注意缩进！！！

1
menu:
2
  # 文章:
3
  #   隧道: /archives/ || icon-box-archive
4
  #   分类: /categories/ || icon-shapes
5
  #   标签: /tags/ || icon-tags
6

7
  友链:
8
    #   友人帐: /link/ || icon-link
9
    朋友圈: /fcircle/ || icon-artstation
10
    #   留言板: /comments/ || icon-envelope
11

12
  # 我的:
13
  #   音乐馆: /music/ || icon-music
14
  #   追番页: /bangumis/ || icon-bilibili1
15
  #   相册集: /album/ || icon-images
16
  #   小空调: /air-conditioner/ || icon-fan
17

18
  关于:
19
    #   关于本人: /about/ || icon-zhifeiji
20
    闲言碎语: /essay/ || icon-lightbulb
21
    #   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

主题配置文件中开启friends_vue.enable，自行设置朋友圈后端地址和顶部模块背景，注意缩进！！！

1
# 朋友圈配置
2
friends_vue:
3
  enable: false
4
  vue_js: https://npm.elemecdn.com/anzhiyu-theme-static@1.1.2/friends/index.f9a2b8d2.js
5
  apiurl: # 朋友圈后端地址
6
  top_background:

参数	备选值/类型	解释
enable	boolean	【必须】是否启用
vue_js	url	【必须】朋友圈前端构建后的 url
apiurl	string	【必须】朋友圈后端 url
top_background	url	【可选】朋友圈顶部背景图

以下是本站配置

1
friends_vue:
2
  enable: true
3
  vue_js: https://npm.elemecdn.com/anzhiyu-theme-static@1.1.2/friends/index.f9a2b8d2.js
4
  apiurl: https://friends.anheyu.com/ # 朋友圈后端地址
5
  top_background: https://img02.anheyu.com/adminuploads/1/2022/08/21/630249e2df20f.jpg

其中vue_js参数，可以将https://npm.elemecdn.com/anzhiyu-theme-static@1.1.2/friends/index.f9a2b8d2.js下载下来后将其中的 friends.anheyu.com替换为您的后端 url 然后上传至您的存储端以url的形式使用。

原项目地址：hexo-circle-of-friends-front

第二种办法也可以自行下载项目后，修改代码中的 url 变量路径friends.anheyu.com为你自己的，然后执行npm run build构建后将dist文件夹中的js上传至您的存储端使用

Tip

注意朋友圈后端爬取需使用common2，否则无法爬取到您的友链数据。

主题配置文件中开启menu中友链和朋友圈的注释，注意缩进！！！

1
menu:
2
  # 文章:
3
  #   隧道: /archives/ || icon-box-archive
4
  #   分类: /categories/ || icon-shapes
5
  #   标签: /tags/ || icon-tags
6

7
  友链:
8
    #  友人帐: /link/ || icon-link
9
    朋友圈: /fcircle/ || icon-artstation
10
  #  留言板: /comments/ || icon-envelope
11

12
  我的:
13
    音乐馆: /music/ || icon-music
14
  #   追番页: /bangumis/ || icon-bilibili1
15
  #   相册集: /album/ || icon-images
16
  #   小空调: /air-conditioner/ || icon-fan
17

18
  关于:
19
    #   关于本人: /about/ || icon-zhifeiji
20
    闲言碎语: /essay/ || icon-lightbulb
21
    #   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

朋友圈页

关于页面配置

2025-01-23T12:32:13.000Z

关于页面配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page about

你会找到 source/about/index.md 这个文件
修改这个文件：记得添加 type: "about"

1
---
2
title: 关于
3
date: 2021-03-30 15:57:51
4
aside: false
5
top_img: false
6
background: "#f8f9fe"
7
comments: false
8
type: "about"
9
---

主题配置文件中开启menu中关于和关于本人的注释，注意缩进！！！

1
menu:
2
# 文章:
3
#   隧道: /archives/ || icon-box-archive
4
#   分类: /categories/ || icon-shapes
5
#   标签: /tags/ || icon-tags
6

7
友链:
8
友人帐: /link/ || icon-link
9
#   朋友圈: /fcircle/ || icon-artstation
10
#   留言板: /comments/ || icon-envelope
11

12
我的:
13
音乐馆: /music/ || icon-music
14
#   追番页: /bangumis/ || icon-bilibili1
15
#   相册集: /album/ || icon-images
16
#   小空调: /air-conditioner/ || icon-fan
17

18
关于:
19
关于本人: /about/ || icon-zhifeiji
20
闲言碎语: /essay/ || icon-lightbulb
21
#   随便逛逛: javascript:toRandomPost() || icon-shoe-prints1

展开收起

新建source/_data/about.yml，输入以下内容

1
- class_name: 关于页
2
  subtitle: 生活明朗，万物可爱✨
3
  avatarImg: https://npm.elemecdn.com/anzhiyu-blog-static@1.0.0/img/avatar.webp
4
  avatarSkills:
5
    left:
6
      - 🤖️ 数码科技爱好者
7
      - 🔍 分享与热心帮助
8
      - 🏠 智能家居小能手
9
      - 🔨 设计开发一条龙
10
    right:
11
      - 专修交互与设计 🤝
12
      - 脚踏实地行动派 🏃
13
      - 团队小组发动机 🧱
14
      - 壮汉人狠话不多 💢
15
  name: 陈志伟
16
  description: 是一名 前端工程师、学生、独立开发者、博主
17
  aboutsiteTips:
18
    tips: 追求
19
    title1: 源于
20
    title2: 热爱而去 感受
21
    word:
22
      - 学习
23
      - 生活
24
      - 程序
25
      - 体验
26
  helloAbout: Hello there!
27
  skillsTips:
28
    tips: 技能
29
    title: 开启创造力
30
  careers:
31
    tips: 生涯
32
    title: 无限进步
33
    list:
34
      - desc: EDU,软件工程专业
35
        color: "#357ef5"
36
      - desc: EDU,软件工程专业
37
        color: "#357ef5"
38
      - desc: EDU,软件工程专业
39
        color: "#357ef5"
40
    img: https://bu.dusays.com/2023/04/21/644287166329b.png
41
  statistic:
42
    link: /archives
43
    text: 文章隧道
44
    cover: https://bu.dusays.com/2023/05/01/644f4b037b930.jpg
45
  map:
46
    title: 我现在住在
47
    StrengthenTitle: 中国，长沙市
48
    background: https://bu.dusays.com/2023/07/05/64a4c61cb20ef.jpg
49
    backgroundDark: https://bu.dusays.com/2023/07/05/64a4c63495ac5.jpg
50
  selfInfo:
51
    selfInfoTips1: 生于
52
    selfInfoContentYear: 2002
53
    selfInfoTips2: 湖南信息学院
54
    selfInfoContent2: 软件工程
55
    selfInfoTips3: 现在职业
56
    selfInfoContent3: 大三学生👨‍🎓
57
  personalities:
58
    author_name: 执政官
59
    personality_type: ESFJ-A
60
    photo_url: https://bu.dusays.com/2023/07/05/64a4c63495ac5.jpg
61
    personality_img: https://npm.elemecdn.com/anzhiyu-blog@2.0.8/img/svg/ESFJ-A.svg
62
    name_url: https://www.16personalities.com/ch/esfj-%E4%BA%BA%E6%A0%BC
63
  maxim:
64
    maxim_tips: 座右铭
65
    maxim_top: 生活明朗，
66
    maxim_bottom: 万物可爱。
67
  buff:
68
    buff_tips: 特长
69
    buff_top: 脑回路新奇的 酸菜鱼
70
    buff_bottom: 二次元指数 MAX
71
  game:
72
    game_tips: 爱好游戏
73
    game_title: 原神
74
    game_uid: "UID: 125766904"
75
    game_bg: https://bu.dusays.com/2023/04/22/64433bf26e25d.webp
76
  comic:
77
    comic_tips: 爱好番剧
78
    comic_title: 追番
79
    comic_list:
80
      - name: 约定的梦幻岛
81
        href: https://www.bilibili.com/bangumi/media/md5267750/?spm_id_from=666.25.b_6d656469615f6d6f64756c65.1
82
        cover: https://bu.dusays.com/2023/05/27/647166c44b414.webp
83
      - name: 咒术回战
84
        href: https://www.bilibili.com/bangumi/media/md28229899/?spm_id_from=666.25.b_6d656469615f6d6f64756c65.1
85
        cover: https://bu.dusays.com/2023/05/24/646db4398832e.webp
86
      - name: 紫罗兰永恒花园
87
        href: https://www.bilibili.com/bangumi/media/md8892/?spm_id_from=666.25.b_6d656469615f6d6f64756c65.1
88
        cover: https://bu.dusays.com/2023/05/24/646db43983d99.webp
89
      - name: 鬼灭之刃
90
        href: https://www.bilibili.com/bangumi/media/md22718131/?spm_id_from=666.25.b_6d656469615f6d6f64756c65.1
91
        cover: https://bu.dusays.com/2023/05/24/646db439856a0.webp
92
      - name: JOJO的奇妙冒险 黄金之风
93
        href: https://www.bilibili.com/bangumi/media/md135652/?spm_id_from=666.25.b_6d656469615f6d6f64756c65.1
94
        cover: https://bu.dusays.com/2023/05/30/64760e38d651a.webp
95
  like:
96
    like_tips: 关注偏好
97
    like_title: 数码科技
98
    like_bg: https://bu.dusays.com/2022/12/06/638f5f05ce1f7.jpg
99
    like_bottom: 手机、电脑软硬件
100
  music:
101
    music_tips: 音乐偏好
102
    music_title: 许嵩、民谣、华语流行
103
    music_bg: https://p2.music.126.net/Mrg1i7DwcwjWBvQPIMt_Mg==/79164837213438.jpg
104
    music_link: /music
105
  reward_list:
106
    - name: 海阔蓝
107
      amount: 8.8
108
      datatime: 2023-03-28
109
    - name: LK66
110
      amount: 66.6
111
      datatime: 2023-03-24
112
    - name: 张时貳
113
      amount: 6.6
114
      datatime: 2023-01-22
115
    - name: ZeroAf
116
      amount: 9.9
117
      datatime: 2022-12-14
118
    - name: LuckyWangXi
119
      amount: 6.6
120
      datatime: 2022-12-14
121
    - name: 刀中日月长
122
      amount: 10
123
      datatime: 2022-11-16
124
    - name: 鹿啵包
125
      amount: 10
126
      datatime: 2022-11-08
127
    - name: 疾速k
128
      amount: 50
129
      datatime: 2022-09-20
130
    - name: 伴舟先生大霖子
131
      amount: 4.03
132
      datatime: 2022-10-27
133
      suffix: 贝壳
134
    - name: Magica_0x0
135
      amount: 3.36
136
      datatime: 2022-10-07
137
      suffix: 贝壳
138
    - name: 名字就是要短像这样
139
      amount: 3.36
140
      datatime: 2022-08-25
141
      suffix: 贝壳
142
    - name: Leviathan520
143
      amount: 1.34
144
      datatime: 2022-08-23
145
      suffix: 贝壳
146
    - name: 托马斯
147
      amount: 10
148
      datatime: 2022-08-19
149
    - name: 哇是猫猫欸
150
      amount: 1.34
151
      datatime: 2022-08-19
152
      suffix: 贝壳

展开收起

参数	备选值/类型	解释
class_name	关于页	【必须】页面类
subtitle	string	【必须】副标题
avatarImg	url	【必须】头像链接
name	string	【必须作者名称
description	string	【必须】描述
aboutsiteTips	object	【必须】站点关于提示相关配置
aboutsiteTips.tips	string	【必须】站点关于提示性文字
aboutsiteTips.title1	string	【必须】站点关于标题文字 1
aboutsiteTips.title2	string	【必须】站点关于标题文字 2
aboutsiteTips.word	list	【必须】站点关于标题滚动文字
helloAbout	string	【必须】hello 文字
skillsTips	object	【必须】技能相关配置
skillsTips.tips	string	【必须】技能提示文字
skillsTips.title	string	【必须】技能标题
careers	object	【必须】生涯相关配置
careers.tips	string	【必须】生涯提示性文字
careers.title	string	【必须】生涯标题
careers.list	list	【可选】生涯 item
careers.list.desc	string	【可选】生涯 item 描述
careers.list.color	string	【可选】生涯 item 圆圈颜色
careers.img	string	【必须】生涯底部图片
statistic	object	【必须】统计数据相关配置
statistic.link	url	【必须】统计数据按钮前往链接
statistic.text	string	【必须】统计数据按钮文字
map	object	【必须】地图相关配置
map.title	string	【必须】地图标题
map.StrengthenTitle	string	【必须】地图大标题
map.background	url	【必须】地图亮色模式背景
map.backgroundDark	url	【必须】地图暗色模式背景
selfInfo	object	【必须】作者相关信息配置
selfInfo.selfInfoTips1	string	【必须】作者相关提示文字 1
selfInfo.selfInfoContentYear	number	【必须】作者生日年份
selfInfo.selfInfoTips2	string	【必须】作者相关提示文字 2
selfInfo.selfInfoContent2	string	【必须】作者相关内容 2
selfInfo.selfInfoTips3	string	【必须】作者相关提示文字 3
selfInfo.selfInfoContent3	string	【必须】作者相关内容 3
personalities	object	【必须】作者性格相关配置
personalities.author_name	string	【必须】作者性格名称
personalities.personality_type	string	【必须】作者性格类型
personalities.photo_url	url	【必须】作者自拍图片
personalities.personality_img	url	【必须】作者性格表述图片
personalities.name_url	url	【必须】点击性格跳转到链接
maxim	object	【必须】座右铭相关配置
maxim.maxim_tips	string	【必须】座右铭相关提示文字
maxim.maxim_top	string	【必须】座右铭相关顶部文字
maxim.maxim_bottom	string	【必须】座右铭相关底部文字
buff	object	【必须】特长相关配置
buff.buff_tips	string	【必须】特长相关提示文字
buff.buff_top	string	【必须】特长相关顶部文字
buff.buff_bottom	string	【必须】特长相关底部文字
game	object	【必须】爱好游戏相关配置
game.game_tips	string	【必须】爱好游戏提示文字
game.game_title	string	【必须】爱好游戏标题
game.game_uid	string	【必须】爱好游戏 uid
game.game_bg	url	【必须】爱好游戏背景
comic	object	【必须】追番相关配置，需要 5 条数据
comic.comic_tips	string	【必须】追番相关提示文字
comic.comic_title	string	【必须】追番相关标题
comic.comic_list	list	【必须】追番相关列表
comic.comic_list.name	string	【必须】追番 item 名称
comic.comic_list.href	url	【必须】追番 item 链接
comic.comic_list.cover	url	【必须】追番 item 的 cover
like	object	【必须】关注偏好相关配置
like.like_tips	string	【必须】关注偏好配置提示文字
like.like_title	string	【必须】关注偏好配置标题
like.like_bg	url	【必须】关注偏好配置背景
like.like_bottom	string	【必须】关注偏好配置底部文字
music	object	【必须】音乐偏好相关配置
music.music_tips	string	【必须】音乐偏好提示性文字
music.music_title	string	【必须】音乐偏好标题
music.music_bg	url	【必须】音乐偏好背景
music.music_link	url	【必须】音乐偏好按钮链接
reward_list	object	【可选】打赏相关配置，如果不配置将没有打赏模块
reward_list.name	string	【必须】打赏 item 名称
reward_list.amount	number	【必须】打赏 item 金额
reward_list.datatime	Date	【必须】打赏 item 时间
reward_list.suffix	string/元	【可选】打赏 item 后缀（默认元）

关于页

安装主题

2025-01-23T12:32:13.000Z

搭建 Hexo 博客#

如果你还没有 Hexo 博客，请按照 Hexo 官方文档进行安装、建站。

作者的话#

请注意_config.anzhiyu.yml中的配置优先级大于_config.yml，所以更新主题后需要比对主题文件夹中的theme/anzhiyu/_config.yml 文件内容，一般在release 的说明里会特别提示或给出配置文件版本对比diff，同步修改原配置文件即可。

Tip

致主题的新用户：

本指南经过数个版本打磨，绝大部分的功能都有详细说明，请仔细阅读，节约自己和他人的时间；
本指南中提到的：“站点配置” 指的 Hexo 博客目录下的 _config.yml，“主题配置” 指的是 theme/anzhiyu/_config.yml 或者 _config.anzhiyu.yml ，注意区分；
本指南中提到的 source 目录都指的是博客目录下的 source 文件夹，不推荐修改主题内 source 目录；
每次无论 hexo g 或 hexo s，都最好先使用 hexo clean 清除本地缓存；
页面结果以本地 hexo s 为准，部署后的异常大部分是线上缓存原因，在确认没有报错的情况下，等待若干时间后即可正常；
由于主题的不同版本会存在配置差异，本指南以最新版本为准。

本指南不包括所有的配置说明，几乎每个配置在主题配置中都有注释，可配合指南共同参考使用。

另外本指南仅包含主题范围内的使用说明，如果是 Hexo 的使用或者 Hexo 插件的使用，请查阅各自的文档。

若存在其他主题相关的疑问请在 issues 留言。

主题安装#

Note

温馨提示

Anzhiyu主题拥有Main(稳定版)和Dev(测试版)两种版本, 我们推荐您安装使用Github(稳定版)以获得最佳的主题体验

方式一(Github 推荐):

Terminal window

1
git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

如遇安装不上可以使用以下url代理安装

Terminal window

1
git clone -b main https://ghproxy.com/https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

方式二(Release 推荐):

下载最新 release 版本解压到 themes 目录，并将解压出的文件夹重命名为 anzhiyu。

方式三(npm安装):

Terminal window

1
npm i hexo-theme-anzhiyu

此方法只支持 Hexo 5.0.0 以上版本通过 npm 安装并不会在 themes 里生成主题文件夹，而是在 node_modules 里生成

测试版Dev

Terminal window

1
git clone -b dev https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

测试版可能存在 bug，追求稳定的请安装稳定版

应用主题#

打开 Hexo 根目录下的 config.yml, 找到以下配置项，把主题改为anzhiyu

1
# Extensions
2

3
## Plugins: https://hexo.io/plugins/
4

5
## Themes: https://hexo.io/themes/
6

7
theme: anzhiyu

安装 pug 和 stylus 渲染插件#

Terminal window

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

无法安装可以使用cnpm进行安装

Terminal window

1
npm install hexo-renderer-pug hexo-renderer-stylus --save --registry=http://registry.npmmirror.com

覆盖配置#

覆盖配置可以使主题配置放置在 anzhiyu 目录之外，避免在更新主题时丢失自定义的配置。

通过 Npm 安装主题的用户可忽略，其他用户建议学习使用。

Terminal window

1
cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml

windows 复制/themes/anzhiyu/_config.yml此文件到 hexo 根目录，并重命名为_config.anzhiyu.yml

以后如果修改任何主题配置，都只需修改 _config.anzhiyu.yml 的配置即可。

注意：

只要存在于 _config.anzhiyu.yml 的配置都是高优先级，修改原 _config.yml 是无效的。
每次更新主题可能存在配置变更，请注意更新说明，可能需要手动对 _config.anzhiyu.yml 同步修改。
想查看覆盖配置有没有生效，可以通过 hexo g --debug 查看命令行输出。
如果想将某些配置覆盖为空，注意不要把主键删掉，不然是无法覆盖的

本地启动 hexo#

Terminal window

1
hexo cl
2
hexo g
3
hexo s

此时就能在看到效果了。

升级方法#

方式一

适用于通过 Github 或 Release 压缩包主题，且没有自行修改任何代码的情况。

先将原文件夹重命名为别的名称，例如 anzhiyu-bkp，用于升级失败进行回退；
选择自己的安装方式升级

Github：重新重新执行安装命令即可

Terminal window

1
git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

Release：按照安装步骤，下载 release 并解压重命名为 anzhiyu；

比对升级后的配置文件_config.yml，如果某些配置发生了变化（改名或弃用），release 的说明里会特别提示或给出配置文件版本对比diff，同步修改原配置文件即可。

方式二

适用于通过 Npm 安装主题。

在博客目录下执行命令：

Terminal window

1
npm update --save hexo-theme-anzhiyu

比对升级后的配置文件_config.yml,如果某些配置发生了变化（改名或弃用），release 的说明里会特别提示或给出配置文件版本对比diff，同步修改原配置文件即可。

方式三

全量更新：删除theme/anzhiyu文件夹，然后重新执行安装命令即可。

Note

视频教程

什么？你还是不会？这里有视频 AnZhiYu 主题安装教程

版本号释义#

本项目的版本号为 X.Y.Z 格式，但与常见的语义化版本号规范有部分区别，具体释义如下：

X: 产品层面的重新设计，包含重大框架重构，会涉及大范围功能变更与配置变更，更新前必须阅读相关文档

Y: 包含中大型新功能，及无法向下兼容的功能变更与配置变更，更新该版本号可能会需要修改配置或者移除一些原功能

Z: 不仅包含 BUG 修复、小型新功能，还会包含可以向下兼容的原功能更新与配置变更，原则上更新该版本号无需额外动作

留言板配置

2025-01-23T12:32:13.000Z

留言板页面配置#

在博客根目录执行

Terminal window

1
npm install hexo-butterfly-envelope --save

在站点配置文件_config.yml中添加以下内容配置，更多配置请查看信笺样式留言板

1
#envelope_comment
2
#seehttps://akilar.top/posts/e2d3c450/
3
envelope_comment:
4
  enable: true #控制开关
5
  custom_pic:
6
    cover: https://npm.elemecdn.com/hexo-butterfly-envelope/lib/violet.jpg #信笺头部图片
7
    line: https://npm.elemecdn.com/hexo-butterfly-envelope/lib/line.png #信笺底部图片
8
    beforeimg: https://npm.elemecdn.com/hexo-butterfly-envelope/lib/before.png # 信封前半部分
9
    afterimg: https://npm.elemecdn.com/hexo-butterfly-envelope/lib/after.png # 信封后半部分
10
  message: #信笺正文，多行文本，写法如下
11
    - 有什么想问的？
12
    - 有什么想说的？
13
    - 有什么想吐槽的？
14
    - 哪怕是有什么想吃的，都可以告诉我哦~
15
  bottom: 自动书记人偶竭诚为您服务！ #仅支持单行文本
16
  height: #1024px，信封划出的高度
17
  path: #【可选】comments 的路径名称。默认为 comments，生成的页面为 comments/index.html
18
  front_matter: #【可选】comments页面的 front_matter 配置
19
    title: 留言板
20
    comments: true
21
    top_img: false
22
    type: envelope

展开收起

追番页面配置

2025-01-23T12:32:13.000Z

追番页面配置#

在博客根目录执行

Terminal window

1
npm install hexo-bilibili-bangumi --save

在 hexo 配置文件_config.yml中加入以下配置，注意不是主题配置文件，更多配置请参考hexo-bilibili-bangumi

1
# 追番插件
2
# https://github.com/HCLonely/hexo-bilibili-bangumi
3
bangumi: # 追番设置
4
  enable: true
5
  source: bili
6
  path:
7
  vmid: 372204786
8
  title: "追番列表"
9
  quote: "生命不息，追番不止！"
10
  show: 1
11
  lazyload: false
12
  loading:
13
  showMyComment: false
14
  pagination: false
15
  metaColor:
16
  color:
17
  webp:
18
  progress:
19
  extraOrder:
20
  proxy:
21
    host: "代理host"
22
    port: "代理端口"
23
  extra_options:
24
    top_img: false
25
    lazyload:
26
      enable: false

展开收起

追番页

标签页配置

2025-01-23T12:32:13.000Z

标签页配置#

前往你的 Hexo 博客的根目录
在 Hexo 博客根目录 [blog]下打开终端，输入

Terminal window

1
hexo new page tags

你会找到 source/tags/index.md 这个文件
修改这个文件：记得添加 type: "tags"

1
---
2
title: 标签
3
date: 2021-04-06 12:01:51
4
type: "tags"
5
comments: false
6
top_img: false
7
---

参数	解释
type	【必须】页面类型，必须为 tags
comments	【可选】是否显示评论
top_img	【可选】是否显示顶部图
orderby	【可选】排序方式：random/name/length
order	【可选】排序次序： 1, asc for ascending; -1, desc for descending

标签页详情

Visual Studio 修改NuGet 包缓存路径

2024-12-23T12:32:13.000Z

Visual Studio 修改NuGet 包缓存路径#

Visual Studio 下载的NuGet包默认会缓存到 C:\Users{Windows用户名}.nuget\packages 下，时间一长就会导致 C盘空间严重不足。

那么怎样去设置，让包缓存文件保存到其他盘呢？

首先我们要找到 Microsoft.VisualStudio.Offline.config 这个文件，它在哪呢？在 C:\Program Files (x86)\NuGet\Config。

再到文件并用记事本打开如下：

image-20250320152927827

我们在中间增加如下配置内容：

1
  <config>
2
      <add key="globalPackagesFolder" value="D:\Nuget\.nuget\packages" />
3
  config>

最终效果如下图：

image-20250320153015594

这样就配置好了，重新打开 Visual Studio 下载 NuGet 包文件后，查看包的引用地址就会发现地址为修改后的地址。

温馨提示：在配置好地址后，可将原来已经缓存的包文件全部拷贝到新的目录中。

47k Star：一款开源免费的 Markdown 编辑器

2024-12-15T20:31:13.000Z

简介#

MarkText 是一款简单优雅的 Markdown 编辑器，适用于 Linux、macOS 和 Windows 系统。它拥有简洁干净的界面设计，没有过多复杂的菜单和按钮，使得用户可以专注于内容创作。无论是新手还是习惯简洁风格的用户，都能轻松上手并享受高效的写作体验。

主要特点#

跨平台： 支持 Linux、macOS 和 Windows 等多个操作系统，用户可以在不同的设备和系统上使用相同的编辑工具，方便在不同平台上进行写作和编辑。
简洁界面： 界面设计简洁，去除了多余的菜单和按钮，让用户更加专注于内容创作。
实时预览： 提供实时预览功能（WYSIWYG），用户在编辑过程中可以即时看到最终的呈现效果，无需频繁切换预览模式，方便用户及时调整格式和内容，提高写作效率。
丰富的语法支持： 支持 CommonMark Spec、GitHub Flavored Markdown Spec 等多种 Markdown 规范，对基础语法以及数学表达式（KaTeX）、front matter 和 emojis 等扩展语法都有很好的支持，能够满足用户多样化的写作需求。
多种编辑模式： 具有源代码模式、打字机模式、焦点模式等多种编辑模式，可以满足用户在不同场景下的写作需求。例如，在源代码模式下可以专注于代码的编写，在打字机模式下可以享受打字时自动滚动屏幕的流畅体验。
强大的表格功能： 表格功能较为强大，支持直接插入预先定义大小的表格，并且可以方便地用鼠标移动列和行，操作简单，无需过多关注底层代码。
开源免费： 采用 MIT 许可证开源，用户可以免费使用，并且开源的特性也使得代码透明度高，安全性有一定保障，同时吸引了众多开发者为其贡献代码，能够不断改进和完善。
丰富的主题： 提供了多种主题，如 Cadmium Light、Material Dark 等，用户可以根据自己的喜好选择主题，并且还支持自定义 CSS 样式，满足用户对于界面个性化的需求。
丰富的快捷键： 提供了丰富的快捷键操作，方便用户快速执行常用的功能，如保存、加粗、斜体、插入代码块、插入表格等，提高编辑效率。

编辑模式展示

源代码模式
打字机模式
焦点模式

总结#

MarkText 是一个非常适合撰写文档、博客和技术文章的工具，尤其适合喜欢 Markdown 格式的用户。其简洁的界面、丰富的功能和跨平台支持使其成为一款不可多得的 Markdown 编辑器。无论是初学者还是资深用户，都能在 MarkText 中找到满意的使用体验。

下载地址#

官网地址：https://www.marktext.cc/
github地址：https://github.com/marktext/marktext

Linux系统Tomcat启动指定JDK版本

2024-12-09T08:31:13.000Z

Linux系统Tomcat启动指定JDK版本#

JDK安装目录

Terminal window

1
/usr/local/java

修改catalina.sh和setclasspath.sh文件#

进入tomcat bin目录

Terminal window

1
../apache-tomcat-8.5.35/bin

两个文件都加入以下内容

Terminal window

1
export JAVA_HOME=/usr/local/java/jdk1.8.0_131/
2
export JRE_HOME=/usr/local/java/jdk1.8.0_131/jre

注意：”=” 左右两边不要有空格，否则会报错!!!!!

git常用命令

2024-11-23T12:32:13.000Z

初始化和配置#

git init - 初始化一个新的Git仓库。
git config --global user.name "Your Name" - 设置全局用户名，用于提交。
git config --global user.email "your_email@example.com" - 设置全局用户邮箱，用于提交。

文件操作#

git status - 查看当前工作目录的状态，显示有变更的文件。
git add - 将指定文件添加到暂存区。
git add . - 添加当前目录下所有变更的文件到暂存区。
git add -A - 添加所有新文件和变更的文件到暂存区。
git reset - 取消暂存区中指定文件的变更。
git rm - 删除指定文件，并将其添加到暂存区。
git rm --cached - 从暂存区中移除指定文件，但不删除工作目录中的文件。

提交和历史#

git commit -m "Commit message" - 提交暂存区中的变更，并添加提交信息。
git log - 查看提交历史。
git diff - 查看工作目录和最后一次提交之间的差异。
git diff HEAD~1 - 查看上一次提交的变更。
git diff --cached - 查看暂存区和最后一次提交之间的差异。

分支和标签#

git branch - 列出所有本地分支。
git branch - 创建一个新分支。
git checkout - 切换到指定分支。
git merge - 将指定分支合并到当前分支。
git branch -d - 删除指定的本地分支。
git push origin - 推送本地分支到远程仓库。
git pull - 从远程仓库拉取变更并合并到当前分支。
git tag - 为当前提交打上标签。
git push origin --tags - 推送所有标签到远程仓库。

远程仓库#

git clone - 克隆一个远程仓库到本地。
git remote add origin - 添加一个远程仓库。
git remote -v - 显示所有远程仓库的URL。
git fetch - 从远程仓库获取最新变更，但不合并。
git push - 将本地变更推送到远程仓库。
git pull - 从远程仓库拉取变更并合并到当前分支。

撤销和修复#

git reset --soft HEAD~1 - 回退到上一次提交，保留变更在暂存区。
git reset --mixed HEAD~1 - 回退到上一次提交，将变更移回工作目录。
git reset --hard HEAD~1 - 回退到上一次提交，丢弃所有工作目录和暂存区的变更。
git revert - 创建一个新的提交，撤销指定提交的变更。

其他有用的命令#

git stash - 临时保存工作目录的变更。
git stash list - 列出所有储藏的变更。
git stash apply - 应用储藏的变更。
git stash drop - 删除指定的储藏变更。
git gc - 清理不必要的文件和优化本地仓库。

这些命令是Git中最基础和最常用的命令，掌握它们可以帮助您更有效地使用Git进行版本控制和代码管理。

【音乐】洛雪音乐助手

2024-10-29T22:32:13.000Z

简介

一个基于 Electron + Vue 开发的开源免费音乐软件，聚合各音乐平台，完善软件设计，覆盖多平台（MAC、windows），搜索、试听、收藏、下载（已不支持无损下载）样样行。

开源

本项目开源发布于 GitHub 面向全世界人用作对技术的学习交流使用

免费且无广告

本项目开发的初衷仅是为了对新技术的学习与研究，因此软件直至停止维护都将会一直保持纯净

多端支持

本项目支持在Windows、Mac OS、Linux、Android平台上运行。

说明

本项目不计划支持IOS。当前版本比128k更高的音质已失效！
官方网站：https://github.com/lyswhut/lx-music-desktop
更新记录：https://github.com/lyswhut/lx-music-desktop/blob/master/CHANGELOG.md

下载

桌面端：

github下载
蓝凑云下载密码：glqw

移动端：

github下载
蓝凑云下载密码：glqw

若链接无法打开请百度：蓝奏云链接打不开

自定义音源

下载并解压六音自定义音源官方页面 | 下载链接(提取码：8mno)
解压，解压，一定要解压！！
打开 设置 > 基本设置 > 音乐来源 > 自定义源管理

自定义源管理

点本地导入，把下载的文件导进去

文件导入

退出来把钩子打上，等待初始化即可。初始化完看起来是这样：

初始化

设置 > 下载设置 > 是否启用下载功能勾上✅

启用下载功能

去搜索歌曲现在就可以下载了

搜索歌曲

在线音源

1、在线音源-原始链接

音源名称	音源链接
SixYin	https://raw.githubusercontent.com/pdone/lx-music-source/main/sixyin/latest.js
monster	https://www.huhaha.vip/static/lxmusic/zh-monster-v1.5.5.js
all-api	https://www.huhaha.vip/static/lxmusic/all-api-v3.js
Huibq	https://fastly.jsdelivr.net/gh/Huibq/keep-alive/render_api.js

2、在线音源-加速链接

音源名称	音源链接
SixYin	https://ghproxy.net/https://raw.githubusercontent.com/pdone/lx-music-source/main/sixyin/latest.js
Huibq	https://ghproxy.net/https://raw.githubusercontent.com/pdone/lx-music-source/main/huibq/latest.js
Flower	https://ghproxy.net/https://raw.githubusercontent.com/pdone/lx-music-source/main/flower/latest.js
Grass	https://tt.tenmeng.com/moonue/js/yecao202412.js

加速链接仅推荐访问 GitHub 受限的用户使用，如果你的网络可以流畅访问 GitHub，建议直接使用原始链接。

3、其它加速站点

当以上链接无法访问时，可将连接开头的 https://ghproxy.net/ 替换为下边任一地址，然后重试。

https://gh.llkk.cc/ https://github.moeyy.xyz/ https://ghproxy.cn/ https://gh.api.99988866.xyz/ https://ghp.ci/

例如，将 https://ghproxy.net/https://raw.githubusercontent.com/pdone/lx-music-source/main/sixyin/latest.js 链接替换为 https://gh.llkk.cc/https://raw.githubusercontent.com/pdone/lx-music-source/main/sixyin/latest.js

4、在线音源使用方法

如果你是桌面端Win/Mac等设备，请参考下图教程导入：

1、打开洛雪音乐软件，依次进入 [设置] – [基本设置] – [音乐来源] – [自定义源管理]

image-20250211101015906

2、选择 [在线导入]

image-20250211101029065

3、粘贴在线音源链接，单击 [导入] 按钮

image-20250211101103801

4、选中音源，提示初始化成功即可。

image-20250211101119852

大功告成

剩下的功能自己探索吧，接下来我们一起愉快的听歌吧

【影视】TVBoxAPP

2024-10-29T21:31:13.000Z

简介 “TVBox开源版APP”，一个专为安卓平台设计的影视播放应用。该应用通过导入特定资源接口，解析各类爬虫源、XP源和采集源，完全无广告且无任何限制。新版本支持多jar（爬虫包）、直播节目预告等功能，并优化了UI聚合检索和阿里网盘资源读取。文章提供了配置方法、相关版本下载链接和多个资源中心地址，帮助用户更好地使用该应用。

平台：

安卓

类型：

影视

TVbox开源版

通过导入特点资源接口,解析各类爬虫源、XP源、采集源等。完全无任何限制,也无任何广告。
原版支持本地功能，聚合模式，支持多种视频格式，增加分辨率、时间及缓冲速度显示，优化采集等等。
新UI聚合检索(长按影片)，支持读取挂载阿里网盘资源，其他功能同原版。
设置 — 配置地址 — 输入你的站源规则 — 确定即可；
新版支持多jar(爬虫包)，增加直播节目预告 EGP。
编辑器 PC Web版 CatVodTVJsonEditor
配置地址---输入站源---确定即可 URL站源规则

相关版本

由于开源版已很久没人维护更新，所以现在网上大部分都是根据该版二开衍生的各种版本

这里引用了奇奇乐享公众号上的一个下载链接，里面包含了大部分的TVBOX相关的版本

https://qiqi2020.lanzouw.com/b09svqv1c

推荐较多有影迷和影视仓仅作参考，也可能其他版本你更喜欢！

资源中心

资源仅来源于网络，不保证最新。如有失效或推荐，可联系站长重新整理和添加！

名称	地址
dxawi	https://dxawi.github.io/0/0.json
饭太硬	http://www.饭太硬.com/tv
小米	http://xhww.fun:63/小米/DEMO.json
唐三	https://gcore.jsdelivr.net/gh/gaotianliuyun/gao/0828.json
小米	http://xhww.fun:63/小米/DEMO.json
FongMI	https://gcore.jsdelivr.net/gh/gaotianliuyun/gao/0827.json
纯一	https://100km.top/0
巧儿	http://pandown.pro/tvbox/tvbox.json
霜灰	https://gcore.jsdelivr.net/gh/lm317379829/PyramidStore/pyramid/py.json
更多地址	https://www.yck2.com/index/applist/tvbox.html

【漫画】异次元APP

2024-10-29T20:32:13.000Z

异次元APP

简介

平台：

安卓

类型：

漫画

异次元

应用界面超级干净清爽，无广告，无多余花哨的东西。
完全免费，没有会员，没有广告骚扰
支持下载缓存，支持离线阅读
支持添加多个图源源，拥有近乎无限的资源，可随时切换源
可一次搜索多源漫画。
加入定制源地址后，可以在一个APP中免费观看全网漫画
现在只支持Android平台，不支持iPhone/iOS

图源(不定时更新)

图源合集（不定时更新）

相关链接

音乐自动化神器！Melody Hub 让你躺着听新歌，订阅歌单自动更新下载

2024-10-29T20:32:13.000Z

朋友们！我发现了一个音乐爱好者的终极神器！#

前阵子我给大家推荐了 LX Music（洛雪音乐）和 COCO 音乐下载站，它们分别解决了我们听音乐和下载音乐的需求。但是，不知道你们有没有遇到过这样的问题：

喜欢的歌单更新了，需要手动去下载新歌曲
想下载新歌，但是没时间手动操作
音乐文件散落在各个地方，管理起来很麻烦

今天我要给大家介绍一个彻底解决这些问题的神器——Melody Hub，它不仅继承了洛雪音乐的所有优点，还增加了订阅歌单和定时下载功能，让你的音乐体验实现完全自动化！

什么是 Melody Hub？#

Melody Hub 是基于洛雪音乐的 Docker 定制版本，它继承了洛雪音乐原有的一切特性，同时增加了订阅歌单和定时下载等自动化功能，为用户提供了更加智能的音乐体验。

为什么 Melody Hub 是音乐爱好者的终极神器？#

1️⃣ 订阅歌单，自动更新#

这是 Melody Hub 最强大的功能之一！你可以订阅你喜欢的歌单，当歌单更新时，Melody Hub 会自动同步更新，让你永远不会错过新音乐。

想象一下，你喜欢的歌手发了新专辑，或者你关注的歌单更新了，你不需要手动去下载，Melody Hub 会自动帮你搞定，等你打开音乐播放器时，新歌曲已经在你的播放列表里了！

2️⃣ 定时下载，解放双手#

Melody Hub 支持设置定时下载任务，你可以根据自己的需求，设置在特定的时间自动下载你订阅的歌单或指定的音乐。

比如，你可以设置每天凌晨自动下载更新的歌单，这样每天早上起床，你就能听到最新的音乐了！

3️⃣ 专为 NAS 用户优化#

Melody Hub 特别为 NAS 用户进行了优化，支持 Docker 部署，让你可以在 NAS 上轻松运行，实现音乐的集中管理和多设备访问。

这样，你的音乐文件都存储在 NAS 上，既安全又方便，所有设备都可以访问同一个音乐库。

4️⃣ 继承洛雪音乐的所有优点#

Melody Hub 完全继承了洛雪音乐的优点，包括：

多平台支持（Windows、macOS、Linux）
多音乐源集成
数据同步服务
无广告、免费使用

5️⃣ 与 COCO 下载站完美配合#

Melody Hub 可以和 COCO 音乐下载站完美配合：

用 COCO 音乐下载站手动搜索和下载特定音乐
用 Melody Hub 订阅歌单和定时自动下载
用 LX Music 在各种设备上播放音乐

我的使用体验#

前几天我在我的 NAS 上部署了 Melody Hub，使用体验真的惊艳到我了：

订阅歌单：我订阅了几个喜欢的歌单，包括我最喜欢的歌手的官方歌单和一些音乐推荐歌单。
设置定时下载：我设置了每天凌晨 2 点自动下载更新的歌单。
自动更新：第二天早上，我打开音乐播放器，发现歌单已经自动更新了，新添加的歌曲也已经下载完成，真的太方便了！
多设备访问：我可以在手机、电脑、平板上都能访问同一个音乐库，随时随地听我喜欢的音乐。
集中管理：所有的音乐文件都存储在 NAS 上，管理起来非常方便，再也不用担心音乐文件散落在各个地方了。

Docker 部署方法#

部署 Melody Hub 非常简单，只需要使用 Docker 即可：

确保你的设备上安装了 Docker
运行以下命令拉取并运行 Melody Hub 容器：

1
services:
2
  melodyhub:
3
    image: geelonn/melodyhub:latest
4
    container_name: melodyhub
5
    restart: unless-stopped
6
    ports:
7
      - "3000:3000"
8
    volumes:
9
      - melodyhub-data:/app/data
10
      - melodyhub-files:/app/music
11
    environment:
12
      - NODE_ENV=production
13
      - PORT=3000
14
      - DATA_DIR=/app/data
15
      - MUSIC_DIR=/app/music
16
      - JWT_SECRET=your-secure-secret-key
17
      - TZ=Asia/Shanghai
18

19
volumes:
20
  melodyhub-data:
21
  melodyhub-files:

展开收起

打开浏览器访问 http://你的服务器IP:3000，你就可以开始使用了！，端口如果占用了，你可以修改配置文件中的左边的端口号。

如何获取音源文件？#

要使用 Melody Hub 的全部功能，你需要配置音源文件。找不到音源文件的朋友，可以私信我发送【音乐】获取。

适合谁用？#

音乐爱好者：想要自动获取最新音乐
NAS 用户：想在 NAS 上部署音乐服务
忙碌的人：没有时间手动下载音乐
歌单控：喜欢关注和收藏各种歌单
多设备用户：需要在多个设备上访问同一音乐库
已经使用洛雪音乐的用户：想体验自动化的音乐管理

互动时间#

你们平时是怎么管理和更新音乐的？有没有遇到过手动下载的麻烦？用了 Melody Hub 后有什么感受？欢迎在评论区分享你的故事！

如果你有任何关于部署或使用的问题，也可以在评论区留言，我会尽力回答！

项目地址#

GitHub 仓库：https://github.com/gefl24/melody-hub

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

【漫画/小说/影视/音乐】益达APP

2024-10-29T20:32:13.000Z

益达APP

简介

平台：

全平台(安卓\IOS\MAC\WIN)

类型：

小说
影视
漫画
音频

flutter + rust 开发! 跨平台

安装包获取:https://github.com/xiaohucode/yidaRule/releases
规则导入：https://github.com/xiaohucode/yidaRule/raw/main/siteRule/ydSource.yds
规则说明文档: https://github.com/xiaohucode/yidaRule/blob/main/Document.md
PS: 规则中有很多失效的了，重在学习怎么制作源！
源第三方地址：https://gcore.jsdelivr.net/gh/xiaohucode/yidaRule/siteRule/ydSource.yds

音乐下载新选择！COCO音乐下载站让你轻松获取无损音乐，Docker 部署超简单

2024-10-29T20:32:13.000Z

朋友们！音乐爱好者的福利来了！#

前阵子我给大家推荐了洛雪音乐和 MusicFree，它们都是非常优秀的音乐播放器，让我们告别了广告和会员限制。但是，不知道你们有没有遇到过这样的问题：有时候听到喜欢的歌曲，想下载下来保存，却发现下载起来很麻烦？

今天我要给大家介绍一个专门的音乐下载工具——COCO音乐下载站，它可以帮你轻松下载各种音乐，甚至包括无损音质！

什么是 COCO音乐下载站？#

COCO音乐下载站是一个基于 Next.js 16 构建的现代化音乐搜索与下载平台，界面设计简约纯净，支持多渠道音乐搜索、在线试听、批量下载，还配备了丝滑的暗黑模式。

为什么推荐 COCO音乐下载站？#

1️⃣ 多源聚合搜索，想听什么搜什么#

COCO音乐下载站支持全网聚合搜索，内置多种音乐源渠道，包括歌曲宝、歌曲海、布谷、QQ音乐、咪咕等，一键切换，再也不用担心找不到想要的歌曲了！

2️⃣ 在线试听，确认后再下载#

内置精美悬浮播放器，支持播放/暂停、进度拖拽、音量调节等功能，你可以先试听确认是你想要的歌曲，再进行下载，避免下载错误。

3️⃣ 批量下载，效率更高#

支持多选歌曲，一键批量打包下载选中的音乐，节省你的时间。

4️⃣ 支持无损音质#

部分音源（如咪咕、QQMP3等）在资源允许的情况下会自动解析出 FLAC 无损格式，让你享受更高品质的音乐。

5️⃣ 丝滑的暗黑模式#

完美适配深色/浅色模式，独家定制的涟漪扩散切换动画，视觉效果惊艳。

Docker 部署方法#

部署 COCO音乐下载站非常简单，只需要使用 Docker 即可，即使你是技术小白，也能轻松搞定！

步骤1：docker-common.yml 一键部署（推荐）#

打开终端或命令行工具，执行以下命令：

Terminal window

1
services:
2
  coco-downloader:
3
    image: markcxx/coco-downloader:latest
4
    container_name: coco-downloader
5
    restart: always
6
    ports:
7
      # 左侧是你宿主机端口，右侧是容器内部固定端口 3000
8
      - "3000:3000"  # 默认端口
9
      # 如果你想自定义端口，例如 8080，就改成：
10
      # - "8080:3000"
11
    environment:
12
      # 容器内部端口固定 3000，不要改
13
      - PORT=3000

步骤2：手动部署（可选）#

Terminal window

1
# 拉取 Docker 镜像
2
docker pull markcxx/coco-downloader:latest
3
# 方式1：默认端口（3000）运行容器，默认端口（3000）
4
docker run -d -p 3000:3000 --name coco-downloader markcxx/coco-downloader:latest
5
# 方式2：自定义端口（例如 8080）
6
docker run -d -p 8080:3000 -e PORT=3000 --name coco-downloader markcxx/coco-downloader:latest

步骤3：访问 COCO音乐下载站#

部署完成后，打开浏览器访问 http://你的服务器IP:3000（如果使用了自定义端口，就访问 http://你的服务器IP:8080），你就可以开始使用了！

我的使用体验#

前几天我部署了 COCO音乐下载站，使用体验真的很棒：

界面简洁美观，操作流畅
搜索功能强大，能找到很多平台的音乐
在线试听功能很实用，可以确认歌曲是否正确
批量下载功能节省了我很多时间
暗黑模式看起来很舒服，眼睛不累

我用它下载了一些喜欢的歌曲，音质很好，有些还支持无损格式，太香了！

与洛雪音乐、MusicFree 配合使用#

COCO音乐下载站可以和洛雪音乐、MusicFree 完美配合：

用 COCO音乐下载站下载你喜欢的音乐
将下载的音乐导入到洛雪音乐或 MusicFree 中
在洛雪音乐或 MusicFree 中享受无广告的音乐体验

这样，你就拥有了一个完整的音乐生态系统，既能下载音乐，又能无广告播放！

适合谁用？#

音乐爱好者：想下载喜欢的音乐保存
音质追求党：想要无损音质的音乐
收集控：喜欢收集各种音乐
podcast 爱好者：下载 podcast 离线收听
任何人：需要下载音乐的人

互动时间#

你们平时都是怎么下载音乐的？遇到过什么困扰？用了 COCO音乐下载站后有什么感受？欢迎在评论区分享你的故事！

如果你有任何关于部署或使用的问题，也可以在评论区留言，我会尽力回答！

项目地址#

GitHub 仓库：https://github.com/markcxx/coco-downloader
demo站：https://cocodownloader.markqq.com/

温馨提示#

COCO音乐下载站仅供个人学习与技术交流使用，严禁用于任何商业用途。所有音乐资源均来源于互联网第三方网站，本项目仅提供数据聚合与检索服务，不存储任何音乐文件。

推荐阅读：

（注：文章部分信息来源于项目官方文档和个人使用体验）

【小说】阅读APP

2024-10-29T20:31:13.000Z

图片

简介【阅读APP】，一个专为安卓平台设计的小说阅读应用。该应用支持自定义书源和规则，用户可以轻松抓取网页数据，方便找书和看书。软件提供高度自定义的阅读界面，包括字体、颜色、背景、行距、段距等设置，并支持替换净化功能，去除广告。此外，还支持本地TXT和EPUB阅读，多种翻页模式供用户选择。文章提供了开源地址、书源订阅源和官方下载链接，帮助用户更好地使用该应用。平台：

安卓

类型：

小说

阅读

自定义书源，自己设置规则，抓取网页数据，规则简单易懂，软件内有规则说明
书源规则支持搜索及发现，所有找书看书功能全部自定义，找书更方便
支持高度自定义阅读界面，切换字体、颜色、背景、行距、段距、加粗、简繁转换等
支持替换净化，去除广告替换内容很方便
支持本地TXT、EPUB阅读，手动浏览，智能扫描
支持多种翻页模式，覆盖、仿真、滑动、滚动等

相关链接

APP下载

记录Dotnet6中使用Redis共享Session的实现

2024-10-23T12:32:13.000Z

前言#

因项目中实际需要，需要对dotnet服务做横向扩展，但是Session默认存储在MemoryCache中，无法实现多台服务器共享Session,导致通过nginx做负载均衡后出现跳登录的情况，因此需要使用Redis共享Session解决此问题。

实现#

安装依赖#

Microsoft.AspNetCore.DataProtection.StackExchangeRedis 6.0.35
Microsoft.Extensions.Caching.StackExchangeRedis 6.0.35

修改startup.cs/Program.cs#

1
        public void ConfigureServices(IServiceCollection services)
2
        {
3
            // ... 其他中间件
4
            services.AddHttpContextAccessor();
5
            services.AddMvc().AddSessionStateTempDataProvider();
6

7
            services.AddHttpClient();
8
            // 注入Session
9
            services.AddSessionService("CacheProvider");
10
            // 使用Redis作为系统缓存
11
            services.AddCacheService("CacheProvider");
12
            services.AddControllersWithViews(ConfigureMvcOptions)
13
                .AddNewtonsoftJson(options =>
14
                {
15
                    options.UseMemberCasing();
16
                    // 格式化时间
17
                    options.SerializerSettings.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.MicrosoftDateFormat;
18
                });
19
            // ... 其他中间件
20
        }

展开收起

services.AddSessionService(“CacheProvider”) 的实现方法

1
 public static void AddSessionService(this IServiceCollection services, string key)
2
 {
3
     using (ServiceProvider provider = services.BuildServiceProvider())
4
     {
5
         IConfiguration configuration = provider.GetRequiredService();
6
         if (configuration == null)
7
         {
8
             throw new ArgumentNullException(nameof(IConfiguration));
9
         }
10
         IConfigurationSection section = configuration.GetSection(key);
11
         if (!section.Exists())
12
         {
13
             Console.WriteLine($"appsetting.json 文件中不存在 '{key}' 配置项，如需使用redis缓存，请增加此配置。将使用系统缓存。");
14
         }
15
         CacheOptions options = section.Get();
16
         if (options == null)
17
         {
18
             Console.WriteLine($"读取appsetting.json中'{key}'配置项失败，请正确配置。将使用系统缓存");
19
         }
20

21
         if (options?.CacheType == CacheTypeEnum.Redis.ToString())
22
         {
23
             Console.WriteLine($"将使用Redis缓存Session信息");
24

25
             var connStr = options.RedisConnectionString;
26
             var dic =
27
                 connStr.Contains(',') && !connStr.Contains(';') ?
28
                     connStr.SplitAsDictionary("=", ",", true) :
29
                     connStr.SplitAsDictionary("=", ";", true);
30

31
             var Server = dic["Server"]?.Trim();
32
             var UserName = dic["UserName"]?.Trim();
33
             var Password = dic["Password"]?.Trim();
34

35
             #region 配置说明
36

37
             // var options = new ConfigurationOptions
38
             // {
39
             //     AbortOnConnectFail = false, // 连接失败时是否中止
40
             //     AllowAdmin = false, // 是否允许使用管理命令
41
             //     ConnectTimeout = 5000, // 连接超时时间（毫秒）
42
             //     SyncTimeout = 5000, // 同步操作超时时间（毫秒）
43
             //     ResponseTimeout = 5000, // 响应超时时间（毫秒）
44
             //     ReconnectRetryPolicy = new LinearRetry(1000), // 重连策略
45
             //     DefaultDatabase = 0, // 默认数据库索引
46
             //     EndPoints = { "localhost:6379" }, // Redis节点的地址和端口
47
             //     Ssl = false, // 是否使用SSL加密连接
48
             //     SslHost = "localhost", // SSL连接时的主机名验证
49
             //     Password = "yourpassword", // Redis认证密码
50
             //     ClientName = "MyClient", // 客户端名称
51
             //     KeepAlive = 1800000 // 保持连接间隔时间（毫秒）
52
             // };
53
             #endregion
54

55
             //获取Redis 连接字符串
56
             ConfigurationOptions redisConfigOption = new ConfigurationOptions();
57
             redisConfigOption.EndPoints.Add(Server);
58
             redisConfigOption.AllowAdmin = false;
59
             redisConfigOption.Password = Password;
60
             redisConfigOption.ConnectTimeout = 60000;
61
             redisConfigOption.ResponseTimeout = 60000;
62
             redisConfigOption.SyncTimeout = 60000;
63
             redisConfigOption.ReconnectRetryPolicy = new LinearRetry(1000);// 重连策略
64
             var redis = ConnectionMultiplexer.Connect(redisConfigOption);//建立Redis 连接
65

66
             //添加数据保护服务，设置统一应用程序名称，并指定使用Reids存储私钥
67
             services.AddDataProtection()
68
                 .SetApplicationName("YZ")
69
                 .PersistKeysToStackExchangeRedis(redis, "DataProtection-Keys");
70

71
             //添加Redis缓存用于分布式Session
72
             services.AddStackExchangeRedisCache(options =>
73
             {
74
                 options.ConfigurationOptions = redisConfigOption;
75
                 options.InstanceName = "YZ";
76
             });
77
         }
78
         //添加Session
79
         services.AddSession(options =>
80
         {
81
             options.Cookie.Name = "YZ";
82
             options.IdleTimeout = TimeSpan.FromMinutes(60 * 60); //设置session的过期时间
83
             options.Cookie.HttpOnly = true; //设置在浏览器不能通过js获得该cookie的值
84
             options.Cookie.IsEssential = true;
85
         });
86

87
     }
88
 }

展开收起

services.AddCacheService(“CacheProvider”); 实现方法

1
    /// 
2
    /// 缓存注册（新生命Redis组件）
3
    /// 
4
    /// 
5
    public static void AddCacheService(this IServiceCollection services, string key)
6
    {
7
        using (ServiceProvider provider = services.BuildServiceProvider())
8
        {
9
            ICache cache = NewLife.Caching.Cache.Default;
10

11
            IConfiguration configuration = provider.GetRequiredService();
12
            if (configuration == null)
13
            {
14
                throw new ArgumentNullException(nameof(IConfiguration));
15
            }
16
            IConfigurationSection section = configuration.GetSection(key);
17
            if (!section.Exists())
18
            {
19
                Console.WriteLine($"appsetting.json 文件中不存在 '{key}' 配置项，如需使用redis缓存，请增加此配置。将使用系统缓存。");
20
            }
21
            CacheOptions options = section.Get();
22
            if (options == null)
23
            {
24
                Console.WriteLine($"读取appsetting.json中'{key}'配置项失败，请正确配置。将使用系统缓存");
25
            }
26

27
            if (options?.CacheType == CacheTypeEnum.Redis.ToString())
28
            {
29
                Console.WriteLine($"将使用Redis缓存");
30
                var redis = new FullRedis();
31
                redis.Init(options.RedisConnectionString);
32
                cache = redis;
33

34
            }
35

36
            services.AddSingleton(cache);
37
        }
38
    }

展开收起

按照以上的配置，就可以实现使用redis共享Session了。

.NET 开发者必备：全面整理常用 dotnet 命令

2024-10-23T12:32:13.000Z

作为 .NET 开发者，你是否经常需要查找命令行指令？本文为你整理了开发过程中最常用的 dotnet 命令，涵盖项目创建、构建、测试、部署等多个方面，助你提升开发效率！

重要的操作命令#

一些常用的命名

创建并添加项目到解决方案#

Terminal window

1
# 创建 Web API 项目
2
dotnet new webapi -o MyWebApi
3

4
# 创建空解决方案
5
dotnet new sln -o MySolution
6

7
# 进入解决方案目录
8
cd MySolution
9

10
# 将 Web API 项目添加到解决方案中
11
dotnet sln add ../MyWebApi/MyWebApi.csproj

发布为独立部署应用（带运行时）#

Terminal window

1
# 发布 Web API 项目，配置为 Release，平台为 win-x64，且自带运行时
2
dotnet publish ../MyWebApi/MyWebApi.csproj -c Release -r win-x64 --self-contained

查看 SDK 和运行时信息#

Terminal window

1
# 查看所有已安装的 .NET SDK 版本
2
dotnet --list-sdks
3

4
# 查看所有已安装的 .NET 运行时版本
5
dotnet --list-runtimes

运行命令#

Terminal window

1
# 指定运行环境为 Development / Production
2
dotnet run --environment Development
3

4
# 指定监听地址（适用于 ASP.NET Core）
5
dotnet run --urls "http://*:5000;https://localhost:5001"
6
#localhost:5000 表示仅本机访问。
7
# 0.0.0.0:5001 表示允许外部机器通过 IP 访问。 Ubantu使用添加
8

9
# 运行指定项目的代码（不切换目录）
10
dotnet run -p ../MyWebApi/MyWebApi.csproj
11

12
# 显示详细构建日志输出
13
dotnet run --verbosity detailed

📁 一、项目与解决方案管理#

✅ 创建新项目#

Terminal window

1
# 创建控制台应用程序
2
dotnet new console -o MyConsoleApp
3

4
# 创建类库项目（Class Library）
5
dotnet new classlib -o MyLibrary
6

7
# 创建 ASP.NET Core Web API 项目
8
dotnet new webapi -o MyWebApi
9

10
# 创建 Blazor Server 项目
11
dotnet new blazorserver -o MyBlazorApp

📂 管理解决方案（.sln）#

Terminal window

1
# 创建一个新的解决方案文件
2
dotnet new sln -o MySolution
3

4
# 将项目添加到解决方案中
5
dotnet sln add MyProject.csproj
6

7
# 从解决方案中移除项目
8
dotnet sln remove MyProject.csproj
9

10
# 查看当前解决方案包含的所有项目
11
dotnet sln list

⚙️ 二、构建与运行项目#

Terminal window

1
# 恢复所有 NuGet 包依赖项
2
dotnet restore
3

4
# 构建项目，默认是 Debug 配置
5
dotnet build
6

7
# 构建发布版本（Release）
8
dotnet build --configuration Release
9

10
# 运行项目（自动先构建再运行）
11
dotnet run

📦 三、发布应用程序#

你可以选择发布为独立部署（Self-contained）或框架依赖（Framework-dependent）：

Terminal window

1
# 发布为独立部署应用（包含运行时），适用于目标机器无 .NET 安装的情况
2
dotnet publish -r win-x64 --self-contained
3

4
# 发布为框架依赖应用（需目标机器安装对应 .NET 运行时）
5
dotnet publish -r win-x64 --framework-dependent

🧪 四、测试与维护#

Terminal window展开收起

1
# 运行项目中的所有单元测试
2
dotnet test
3

4
# 只运行指定名称的测试方法/类
5
dotnet test --filter MyTest
6

7
# 列出当前项目直接引用的 NuGet 包
8
dotnet list package
9

10
# 列出包括传递依赖在内的所有包信息
11
dotnet list package --include-transitive
12

13
# 添加一个 NuGet 包引用
14
dotnet add package Newtonsoft.Json
15

16
# 移除一个 NuGet 包引用
17
dotnet remove package Newtonsoft.Json
18

19
# 添加对本地项目的引用（如类库）
20
dotnet add reference ../MyLib/MyLib.csproj

展开收起

🧰 五、SDK 与环境信息#

Terminal window

1
# 显示当前默认使用的 SDK 和运行时详细信息
2
dotnet --info
3

4
# 列出系统中已安装的所有 .NET SDK 版本
5
dotnet --list-sdks
6

7
# 列出系统中已安装的所有 .NET 运行时版本
8
dotnet --list-runtimes
9

10
# 显示 dotnet CLI 的帮助信息
11
dotnet help
12

13
# 使用指定版本的 SDK 执行某个命令（例如使用 6.0.100）
14
dotnet --sdk-version 6.0.100 build

📦 六、NuGet 包管理#

Terminal window

1
# 恢复所有 NuGet 包（等价于 restore）
2
dotnet restore
3

4
# 清除本地 NuGet 缓存（解决缓存导致的问题）
5
dotnet nuget locals all --clear
6

7
# 将项目打包成 .nupkg 文件（用于私有或公共 NuGet 源发布）
8
dotnet pack
9

10
# 将 NuGet 包推送到指定源（如 nuget.org）
11
dotnet nuget push MyPackage.nupkg --source https://api.nuget.org/v3/index.json

🔧 七、其他实用命令#

Terminal window展开收起

1
# 调用 MSBuild 并执行自定义目标（Target）
2
dotnet msbuild /t:CustomTarget
3

4
# 查看详细的构建日志输出（用于调试构建问题）
5
dotnet build --verbosity detailed
6

7
# 启动 .NET Interactive 工具（支持 C# 即时执行和 Jupyter Notebook）
8
dotnet interactive
9

10
# 查看构建性能摘要（优化构建耗时）
11
dotnet build --performance-summary
12

13
# 使用本地安装的 dotnet tool
14
dotnet tool run 
15

16
# 启用源码链接调试（调试 NuGet 包时跳转 GitHub）
17
dotnet run --sourceLink

展开收起

🧪 八、调试与性能分析相关命令#

Terminal window

1
# 启用 AOT 编译（.NET 7+ 功能）
2
dotnet run --aot
3

4
# 收集内存使用情况（用于 PerfView 分析）
5
dotnet run --collect:Memory
6

7
# 启用单文件发布并运行（.NET 6+）
8
dotnet publish -r win-x64 --self-contained -p:PublishSingleFile=true
9
dotnet run --no-build --framework net6.0

如果你觉得这篇文章对你有帮助，欢迎点赞、收藏并分享给更多开发者！让我们一起学习，共同进步！

集群环境下，你不得不注意的ASP.NET Core Data Protection 机制

2024-10-23T12:31:13.000Z

前言#

最近线上环境遇到一个问题，就是ASP.NET Core Web应用在单个容器使用正常，扩展多个容器无法访问的问题。查看容器日志，发现以下异常：

1
warn: Microsoft.AspNetCore.Session.SessionMiddleware[7] Error unprotecting the session cookie. System.Security.Cryptography.CryptographicException: The key {3b046482-7cff-475b-b252-d12ab389d6c3} was not found in the key ring. For more information go to http://aka.ms/dataprotectionwarning at Microsoft.AspNetCore.DataProtection.KeyManagement.KeyRingBasedDataProtector.UnprotectCore(Byte[] protectedData, Boolean allowOperationsOnRevokedKeys, UnprotectStatus& status) at Microsoft.AspNetCore.DataProtection.KeyManagement.KeyRingBasedDataProtector.DangerousUnprotect(Byte[] protectedData, Boolean ignoreRevocationErrors, Boolean& requiresMigration, Boolean& wasRevoked) at Microsoft.AspNetCore.DataProtection.KeyManagement.KeyRingBasedDataProtector.Unprotect(Byte[] protectedData) at Microsoft.AspNetCore.Session.CookieProtection.Unprotect(IDataProtector protector, String protectedText, ILogger logger)

通过排查，发现了是由于 ASP.NET Core Data Protection 机制引起的。

ASP.NET Core Data Protection 机制#

Data Protection（数据安全）机制：为了确保Web应用敏感数据的安全存储，该机制提供了一个简单、基于非对称加密改进的、性能良好的、开箱即用的加密API用于数据保护。它不需要开发人员自行生成密钥，它会根据当前应用的运行环境，生成该应用独有的一个私钥。这在单一部署的情况下没有问题。一旦在集群环境下进行水平扩展，那么每个独立的应用都有一个独立的私钥。这样在负载均衡时，一个请求先在A容器建立的Session会话，该机制会通过当前容器的密钥加密Cookie写入到客户端，下个请求路由到B容器，携带的Cookie在B容器是无法通过B容器的密钥进行解密。进而会导致会话信息丢失的问题。所以在集群情况下，为了确保加密数据的互通，应用必须共享私钥。

私钥共享#

这里以使用Redis来共享私钥举例，添加Microsoft.AspNetCore.DataProtection.StackExchangeRedis Nuget包用于存储密钥。添加Microsoft.Extensions.Caching.StackExchangeRedisNuget包用于配置分布式Session。

1
public IServiceProvider ConfigureServices(IServiceCollection services)
2
{
3

4
    //获取Redis 连接字符串
5
    var redisConnStr = this.Configuration.GetValue<string>(SigeAppSettings.Redis_Endpoint);
6
    var redis = ConnectionMultiplexer.Connect(redisConnStr);//建立Redis 连接
7

8
    //添加数据保护服务，设置统一应用程序名称，并指定使用Reids存储私钥
9
    services.AddDataProtection()
10
        .SetApplicationName(Assembly.GetExecutingAssembly().FullName)
11
        .PersistKeysToStackExchangeRedis(redis, "DataProtection-Keys");
12

13
    //添加Redis缓存用于分布式Session
14
    services.AddStackExchangeRedisCache(options =>
15
    {
16
        options.Configuration = redisConnStr;
17
        options.InstanceName =Assembly.GetExecutingAssembly().FullName;
18
    });
19

20
    //添加Session
21
    services.AddSession(options =>
22
    {
23
        options.Cookie.Name = Assembly.GetExecutingAssembly().FullName;
24
        options.IdleTimeout = TimeSpan.FromMinutes(20);//设置session的过期时间
25
        options.Cookie.HttpOnly = true;//设置在浏览器不能通过js获得该cookie的值
26
        options.Cookie.IsEssential = true;
27
    }
28
   );
29
}

展开收起

Tailscale：不用公网IP，不用配置防火墙，3分钟搞定异地组网！

2024-09-09T20:31:13.000Z

【前言】#

图片

兄弟们，先别急着滑走！

今天阿江要给你们安利一款内网穿透神器——Tailscale。

不是广告，不是恰饭，纯纯是我最近被它惊艳到，忍不住来分享。

如果你也和我一样，经常遇到以下情况：

家里NAS在公司访问不了
远程桌面连不上
异地组网太复杂，公网IP、端口映射、防火墙一头雾水

那你一定要看完这篇文章。

我敢说，Tailscale可能是2025年最被低估的网络工具之一。

【一、Tailscale到底是啥？】#

图片

先别被它的名字吓到，Tailscale不是啥尾巴 scale，也不是宠物美容品牌。

它是一个基于WireGuard的异地组网工具，主打的就是一个“简单“。

官网地址我放这儿了，自己去看：

👉 https://tailscale.com

简单来说，Tailscale能让你把不同地方的设备，组成一个虚拟局域网。

不管是Windows、macOS、Linux，还是iOS、Android、NAS，它全支持。

而且，不用公网IP，不用配置路由器，不用开端口，3分钟搞定。

【二、3个场景，彻底被圈粉】#

图片

✅ 场景1：公司访问家里NAS，像本地一样打开#

我人在深圳，家里有一台群晖NAS，装了很多资料。

以前想远程访问，得搞公网IP、DDNS、端口映射，折腾一下午还不一定成功。

现在我用Tailscale，3分钟装好，直接访问192.168.x.x，像本地一样打开。

不用公网IP，不用路由器设置，甚至不用重启NAS。

那一刻，我真的有点感动。

✅ 场景2：异地远程桌面，延迟低到离谱#

我老家有台Windows主机，装了Pr和Ae。

那天我回湖南过年，临时要剪个片子。

我用Tailscale连上老家电脑，直接远程桌面开Pr，操作丝滑得像本地一样。

延迟不到30ms，我甚至还能实时预览1080p素材。

不用向日葵，不用TeamViewer，不用开端口。

✅ 场景3：手机远程控制树莓派，SSH秒连#

我在广州，树莓派放在北京朋友家，做内网监控。

以前想SSH上去，得让他帮我开端口，还经常掉线。

现在我用Tailscale，手机打开Termius，直接SSH连接，秒连。

不走公网，不暴露端口，端到端加密。

【三、Tailscale凭啥这么简单？】#

图片

我研究了一下，Tailscale之所以能这么猛，主要靠这几招：

技术点

说人话

基于WireGuard

最安全、最快的VPN协议之一

NAT穿透

不用公网IP，也能打洞成功

控制服务器中转

打洞失败时，官方服务器 relay，不丢包

端到端加密

数据不经过第三方，隐私安全

P2P直连

一旦打洞成功，速度直接拉满

一句话总结：它不是VPN，它是“魔法局域网”。

【四、Tailscale到底适合谁？】#

图片

人群

用途

NAS用户

远程访问群晖、威联通、UNRAID

程序员

远程SSH、访问内网Git、调试服务器

远程办公族

远程桌面、访问公司内网、打印机等

家庭用户

异地访问摄像头、智能家居、下载机

技术爱好者

组网、穿透、内网服务暴露

一句话：只要你有多台设备，Tailscale就能让它们“像在同一屋檐下”。

【五、Tailscale怎么用？】#

图片

✅ 第一步：下载安装#

官网：https://tailscale.com

支持Windows、macOS、Linux、iOS、Android、NAS（群晖、威联通、UNRAID）

✅ 第二步：注册账号#

用Google、Microsoft、GitHub账号一键登录。

✅ 第三步：安装并登录#

每台设备都装Tailscale，登录同一个账号。

图片

✅ 第四步：查看虚拟IP#

每台设备会分配一个100.x.x.x的IP地址，全网唯一。

图片

✅ 第五步：直接访问#

图片

比如：

家里NAS：100.64.0.1:5000
公司电脑：100.64.0.2:3389
树莓派：100.64.0.3:22

无需端口映射，无需公网IP，直接访问。

【六、Tailscale的隐藏彩蛋】#

图片

✅ 支持ACL权限控制#

你可以设置谁能访问谁，比如：

只允许自己访问NAS
只允许同事访问测试服务器

图形化配置，不用写防火墙规则。

✅ 支持Exit Node#

你可以把某台设备设置为出口节点，比如：

人在国外，想走家里IP访问国内网站
人在公司，想走家里网络访问内网

一键切换，比VPN还方便。

✅ 支持MagicDNS#

每台设备都有一个自定义域名，比如：

nas.tailnet.ts.net
pi.tailnet.ts.net

不用记IP，直接域名访问。

【七、Tailscale的缺点】#

图片

阿江不吹不黑，Tailscale也不是完美。

缺点

说明

免费版设备限制

最多100台设备，个人够用

国内网络偶尔抽风

打洞失败时会走官方中继，速度一般

需要登录第三方账号

不支持国内邮箱注册

企业版收费不便宜

高级功能需付费，个人用户无感

但说实话，这些缺点在它的优点面前，真的不算啥。

【八、Tailscale vs 其他内网穿透工具】#

图片

工具	是否需公网IP	是否需配置	是否加密	是否P2P	是否免费
Tailscale	❌	❌	✅	✅	✅
FRP	✅	✅	✅	❌	✅
NPS	✅	✅	✅	❌	✅
ZeroTier	❌	❌	✅	✅	✅
花生壳	❌	❌	❌	❌	❌

结论：Tailscale就是“懒人版内网穿透天花板”。

【九、建议】#

图片

如果你：

有NAS，想远程访问
有多台设备，想异地组网
不想折腾路由器、防火墙、公网IP
想安全、稳定、快速地访问内网

Tailscale，真的值得你试试。

它不是万能，但它在你需要的场景里，几乎就是最优解。

【十、写在最后】#

图片

PicList-轻松管理你的图片库，让美好瞬间触手可及

2024-09-09T20:31:13.000Z

🚀 发现 PicList：超越 PicGo 的图片管理新星！#

在日常工作中，我们经常需要上传、管理和分享图片。无论是开发者还是普通用户，找到一个好用的工具来辅助这项任务都是至关重要的。今天，我要向大家推荐一个在 PicGo 基础上进行了深度二次开发的图片管理工具——PicList。它不仅继承了 PicGo 的所有优秀特性，如支持多种图床服务（如 GitHub、SM.MS 等），而且还引入了更多高级功能，使其成为图片管理领域的佼佼者。🌈

为什么选择 `PicList`？#

PicList 是一款高效且易于使用的云存储和图床管理工具。它不仅完美保留了 PicGo 的所有优点，还增添了许多令人惊喜的新功能。

新增特性一览#

相册同步：支持云端文件的同步删除，确保本地和云端的一致性。
多图床支持：除了常见的图床选项外，PicList 还内置了 WebDav、本地图床和 SFTP 等多种图床服务。
云存储管理：增加了完整的云端存储管理功能，包括目录查看、文件搜索、批量上传下载及删除文件。
链接复制：能够复制多种格式的文件链接，方便在不同场景下使用。
预览功能：支持图片、Markdown 文档、文本和视频的预览，无需离开应用即可查看文件内容。

如何开始使用 `PicList`？#

安装#

首先，你需要从官方网站下载适用于你操作系统的 PicList 版本。安装过程非常直观，只需按照安装向导的指示操作即可完成。

配置#

启动 PicList 后，你需要配置你常用的图床服务。这通常涉及到输入访问凭证或者创建一个新的账户。PicList 的用户界面设计友好，每一步都有明确的提示，因此即便是第一次使用也能轻松搞定。

使用技巧#

批量上传：当需要上传大量图片时，可以利用批量上传功能，极大地提高了工作效率。
云端同步：保持本地文件夹与云端图床的实时同步，确保任何时候都能访问到最新版本的图片。
预览功能：在上传前，先使用预览功能检查图片是否符合要求，避免不必要的重复上传。

结语#

PicList 不仅仅是一款工具，更是图片管理领域的一次革新。它不仅简化了图片上传的过程，还通过丰富的功能增强了用户体验。如果你正在寻找一个既强大又灵活的图片管理解决方案，那么 PicList 绝对值得一试！🚀

希望这篇博客能帮助你更好地了解 PicList 的优势，并鼓励更多的用户尝试使用它。如果你有任何疑问或想要了解更多细节，欢迎访问 PicList 的官方网站或者加入社区讨论！🤝

JSDelivr & NPM CDN 国内加速节点

2024-09-08T20:31:13.000Z

JSDelivr 节点#

节点名称	描述	可用性
cdn.jsdelivr.net	通用节点	低
gcore.jsdelivr.net	Gcore 节点	高
testingcf.jsdelivr.net	Cloudflare 节点	高
quantil.jsdelivr.net	Quantil 节点	尚可
fastly.jsdelivr.net	Fastly 节点	尚可
originfastly.jsdelivr.net	Fastly 节点	低
test1.jsdelivr.net	Cloudflare 节点	低

第三方提供的 jsdelivr 节点：#

jsd.cdn.zzko.cn：国内 CDN
jsd.onmicrosoft.cn：国内 CDN
jsdelivr.b-cdn.net：台湾 CDN
cdn.jsdelivr.us：Anycast（国内速度很快，但稳定性未知）

NPM 节点#

节点名称	描述	注意事项
unpkg.com	国内几乎不可用	-
npm.elemecdn.com	饿了么	同步快，缺的多
npm.onmicrosoft.cn	公益	需准确的版本号
unpkg.zhimg.com	知乎	同步慢
npm.akass.cn	公益	需准确的版本号
cdn.chuqis.com/npm/	公益	需准确的版本号
code.bdstatic.com/npm	百度	仅同步热门包

效率提升利器，一个全龄段友好的DotNET万能工具库

2024-09-03T12:31:13.000Z

项目介绍#

Masuit.Tools(码数吐司库)是一个全龄段友好的C#/.NET万能工具库，不管你是菜鸟新手还是骨灰级玩家都能轻松上手。

包含功能#

这个库包含一些常用的操作类，大都是静态类，加密解密，反射操作，树结构，文件探测，权重随机筛选算法，分布式短id，表达式树，linq扩展，文件压缩，多线程下载，硬件信息，字符串扩展方法，日期时间扩展操作，中国农历，大文件拷贝，图像裁剪，验证码，断点续传，集合扩展、Excel导出等常用封装。

诸多功能集一身，代码量不到2MB！

图片

建议开发环境#

操作系统：Windows 11 23H2及以上版本.
开发工具：VisualStudio2022 v17.8及以上版本.
SDK：.Net Core 2.1.0及以上所有版本.

字符串检查#

检验字符串是否是Email、手机号、URL、IP地址、身份证号等

1
var (isMatch, match) = "337845818@qq.com".MatchEmail(); // 可在appsetting.json中添加EmailDomainWhiteList和EmailDomainBlockList配置邮箱域名黑白名单，逗号分隔，如"EmailDomainBlockList": "^\\w{1,5}@qq.com,^\\w{1,5}@163.com,^\\w{1,5}@gmail.com,^\\w{1,5}@outlook.com",
2
bool isInetAddress = "114.114.114.114".MatchInetAddress(); // 匹配IP地址
3
bool isUrl = "http://masuit.org/20/history".MatchUrl(); // 匹配url
4
bool isPhoneNumber = "15205201520".MatchPhoneNumber(); // 匹配手机号
5
bool isLandline = "01088888888".MatchLandline(); // 匹配座机号
6
bool isIdentifyCard = "312000199502230660".MatchIdentifyCard();// 校验中国大陆身份证号
7
bool isCNPatentNumber = "200410018477.9".MatchCNPatentNumber(); // 校验中国专利申请号或专利号，是否带校验位，校验位前是否带“.”，都可以校验，待校验的号码前不要带CN、ZL字样的前缀
8
bool isUSCC = "200410018477.9".MatchUSCC(); // 校验企业统一社会信用代码

硬件监测#

硬件监测(需要管理员权限，仅支持Windows，部分函数仅支持物理机模式)!

1
float load = SystemInfo.CpuLoad;// 获取CPU占用率
2
long physicalMemory = SystemInfo.PhysicalMemory;// 获取物理内存总数
3
long memoryAvailable = SystemInfo.MemoryAvailable;// 获取物理内存可用率
4
double freePhysicalMemory = SystemInfo.GetFreePhysicalMemory();// 获取可用物理内存
5
double temperature = SystemInfo.GetCPUTemperature();// 获取CPU温度
6
int cpuCount = SystemInfo.GetCpuCount();// 获取CPU核心数
7
var ipAddress = SystemInfo.GetLocalIPs();// 获取本机所有IP地址
8
string localUsedIp = SystemInfo.GetLocalUsedIP();// 获取本机当前正在使用的IP地址
9
IList<string> macAddress = SystemInfo.GetMacAddress();// 获取本机所有网卡mac地址
10
string osVersion = Windows.GetOsVersion();// 获取操作系统版本
11
RamInfo ramInfo = SystemInfo.GetRamInfo();// 获取内存信息
12
var cpuSN=SystemInfo.GetCpuInfo()[0].SerialNumber; // CPU序列号
13
var driveSN=SystemInfo.GetDiskInfo()[0].SerialNumber; // 硬盘序列号
14

15
// 快速方法
16
var cpuInfos = CpuInfo.Locals; // 快速获取CPU的信息
17
var ramInfo = RamInfo.Local; // 快速获取内存的信息
18
var diskInfos = DiskInfo.Locals; // 快速获取硬盘的信息
19
var biosInfo = BiosInfo.Local; // 快速获取主板的信息

展开收起

LinqExtension#

1
using System;
2
using System.Collections.Generic;
3
using System.Linq.Expressions;
4

5
namespace Masuit.Tools.Linq;
6

7
/// <summary>
8
/// LINQ扩展方法
9
/// summary>
10
public static class LinqExtension
11
{
12
    /// <summary>
13
    /// 与连接
14
    /// summary>
15
    /// <typeparam name="T">类型typeparam>
16
    /// <param name="left">左条件param>
17
    /// <param name="right">右条件param>
18
    /// <returns>新表达式returns>
19
    public static Expression<Func<T, bool>> And<T>(this Expression<Func<T, bool>> left, Expression<Func<T, bool>> right)
20
    {
21
        return CombineLambdas(left, right, ExpressionType.AndAlso);
22
    }
23

24
    /// <summary>
25
    /// 与连接
26
    /// summary>
27
    /// <typeparam name="T">类型typeparam>
28
    /// <param name="left">左条件param>
29
    /// <param name="condition">符合什么条件param>
30
    /// <param name="right">右条件param>
31
    /// <returns>新表达式returns>
32
    public static Expression<Func<T, bool>> AndIf<T>(this Expression<Func<T, bool>> left, bool condition, Expression<Func<T, bool>> right)
33
    {
34
        return condition ? CombineLambdas(left, right, ExpressionType.AndAlso) : left;
35
    }
36

37
    /// <summary>
38
    /// 与连接
39
    /// summary>
40
    /// <typeparam name="T">类型typeparam>
41
    /// <param name="left">左条件param>
42
    /// <param name="condition">符合什么条件param>
43
    /// <param name="right">右条件param>
44
    /// <returns>新表达式returns>
45
    public static Expression<Func<T, bool>> AndIf<T>(this Expression<Func<T, bool>> left, Func<bool> condition, Expression<Func<T, bool>> right)
46
    {
47
        return condition() ? CombineLambdas(left, right, ExpressionType.AndAlso) : left;
48
    }
49

50
    /// <summary>
51
    /// 或连接
52
    /// summary>
53
    /// <typeparam name="T">类型typeparam>
54
    /// <param name="left">左条件param>
55
    /// <param name="right">右条件param>
56
    /// <returns>新表达式returns>
57
    public static Expression<Func<T, bool>> Or<T>(this Expression<Func<T, bool>> left, Expression<Func<T, bool>> right)
58
    {
59
        return CombineLambdas(left, right, ExpressionType.OrElse);
60
    }
61

62
    /// <summary>
63
    /// 或连接
64
    /// summary>
65
    /// <typeparam name="T">类型typeparam>
66
    /// <param name="left">左条件param>
67
    /// <param name="condition">符合什么条件param>
68
    /// <param name="right">右条件param>
69
    /// <returns>新表达式returns>
70
    public static Expression<Func<T, bool>> OrIf<T>(this Expression<Func<T, bool>> left, bool condition, Expression<Func<T, bool>> right)
71
    {
72
        return condition ? CombineLambdas(left, right, ExpressionType.OrElse) : left;
73
    }
74

75
    /// <summary>
76
    /// 或连接
77
    /// summary>
78
    /// <typeparam name="T">类型typeparam>
79
    /// <param name="left">左条件param>
80
    /// <param name="condition">符合什么条件param>
81
    /// <param name="right">右条件param>
82
    /// <returns>新表达式returns>
83
    public static Expression<Func<T, bool>> OrIf<T>(this Expression<Func<T, bool>> left, Func<bool> condition, Expression<Func<T, bool>> right)
84
    {
85
        return condition() ? CombineLambdas(left, right, ExpressionType.OrElse) : left;
86
    }
87

88
    private static Expression<Func<T, bool>> CombineLambdas<T>(this Expression<Func<T, bool>> left, Expression<Func<T, bool>> right, ExpressionType expressionType)
89
    {
90
        var visitor = new SubstituteParameterVisitor
91
        {
92
            Sub =
93
            {
94
                [right.Parameters[0]] = left.Parameters[0]
95
            }
96
        };
97

98
        Expression body = Expression.MakeBinary(expressionType, left.Body, visitor.Visit(right.Body));
99
        return Expression.Lambda<Func<T, bool>>(body, left.Parameters[0]);
100
    }
101
}
102

103
internal class SubstituteParameterVisitor : ExpressionVisitor
104
{
105
    public Dictionary<Expression, Expression> Sub = new();
106

107
    protected override Expression VisitParameter(ParameterExpression node)
108
    {
109
        return Sub.TryGetValue(node, out var newValue) ? newValue : node;
110
    }
111
}

展开收起

开源地址#

https://github.com/ldqk/Masuit.Tools

配置	解释
index_img	主页的 top_img，示例值: index_img: “background: url(https://img02.anheyu.com/xxx) top / cover no-repeat”
default_top_img	默认的 top_img，当页面的 top_img 没有配置时，会显示 default_top_img
archive_img	归档页面的 top_img
tag_img	tag 子页面的默认 top_img
tag_per_img	tag 子页面的 top_img，可配置每个 tag 的 top_img
category_img	category 子页面的默认 top_img
category_per_img	category 子页面的 top_img，可配置每个 category 的 top_img

配置的值	效果
留空	显示默认的 top_img（如有），否则显示默认的顔色（文章页 top_img 留空的话，会显示 cover 的值）
顔色( HEX 值 - #0000FF RGB 值 - rgb(0,0,255) 顔色单词 - orange 渐变色 - linear-gradient( 135deg, #E2B0FF 10%, #9F44D3 100%)	对应的顔色
transparent	透明
false	不显示 top_img

配置	解释
limit	显示的数量
storage	设置缓存时间，单位分钟
avatar	是否显示头像

小王的博客

【工具】GitHub 多账号 SSH 配置完整指南

前言#

第一步：生成两套独立的 SSH 密钥#

第二步：创建 / 修改 ~/.ssh/config#

第三步：测试连通性#

第四步：修改 B 仓库的 remote 地址#

第五步：设置本仓库独立的提交作者#

第六步：以后的使用规范#

快速自检命令#

常见报错：Permission denied (publickey) 排查#

高频坑：remote 地址写错了#

按顺序排查（先测试 SSH 连通性）#

情况一：依旧返回 Permission denied (publickey)#

情况二：返回成功 Hi B用户名! You've successfully authenticated...#

排查顺序总结#

常见问题#

总结#

Linux 磁盘空间检查与新硬盘挂载完整指南

前言#

一、挂载前磁盘检查#

1. 查看已挂载磁盘使用率#

2. 查看块设备，识别新硬盘#

3. 查看磁盘分区详情#

4. 查看目录占用空间#

5. 检查 inode 是否耗尽#

二、新硬盘完整挂载流程#

Step 1：分区（可选）#

Step 2：格式化（麒麟 V10 推荐 XFS）#

Step 3：创建挂载目录#

Step 4：临时挂载测试#

Step 5：获取 UUID 并配置开机自动挂载#

Step 6：校验 fstab 配置（极其重要！）#

三、挂载后确认#

四、常见问题：普通用户如何免 sudo 操作挂载目录#

方案一：修改目录属主（推荐用于普通业务数据）#

方案二：MySQL 数据目录场景（特殊处理）#

补充：让权限配置开机自动生效#

五、总结#

【工具】一行命令激活 JetBrains 全家桶，再也不用东奔西跑了

前言#

前置条件#

第一步：下载安装 JetBrains 产品#

第二步：运行一次以生成配置文件#

第三步：执行激活命令#

第四步：复制激活码#

第五步：配置防火墙（重要）#

其他平台#

macOS 用户#

激活原理#

总结#

GitHub热门项目！Tolaria：本地优先的Markdown知识库，让AI直接读你的笔记！

朋友们！想让AI直接读你的笔记吗？#

📚 项目介绍#

核心特点#

设计原则#

🚀 安装方式#

方式一：Homebrew（macOS）#

方式二：官网下载#

🎯 使用指南#

第一次启动#

创建知识库（Vault）#

创建笔记#

使用Git同步#

AI集成（重点）#

配置Claude Code#

配置Codex CLI#

使用AGENTS文件#

快捷键使用#

💡 使用场景#

个人第二大脑#

公司文档管理#

AI助手记忆存储#

技术写作与研究#

日记与个人发展#

📊 对比其他工具#

📝 我的使用感受#

🎯 总结#

📌 项目资源#

GitHub热门项目！OmniGet：一个App下载1800+网站，课程、视频、音乐全搞定！

第二步：创建 / 修改 `~/.ssh/config`#

常见报错：`Permission denied (publickey)` 排查#

情况一：依旧返回 `Permission denied (publickey)`#

情况二：返回成功 `Hi B用户名! You've successfully authenticated...`#