教程 - 分类 - Nite

KDE Wayland 虚拟屏：krfb-virtualmonitor + Sunshine 串流

nite@nite07.com (Nite) — Tue, 26 May 2026 17:07:22 +1000

用 krfb-virtualmonitor 在 KDE Wayland 下创建虚拟显示器，配合 Sunshine kwin 捕获和 Moonlight 快捷键切换，不碰内核参数。

Rootless Podman 运行 Gitea Runner

nite@nite07.com (Nite) — Tue, 19 May 2026 12:00:00 +1000

本文属于「quadlet 配置分享」系列。Quadlet 入门见 Podman 教程，完整 Gitea 配置见 Quadlet 配置分享：Gitea。

用 rootless Podman 跑 Gitea Actions Runner 时遇到的问题，记录一下。

Job 容器创建失败：making volume mountpoint

Runner 正常启动后，执行工作流时报错：

给 Agent 接入 Playwright MCP + CloakBrowser

nite@nite07.com (Nite) — Tue, 19 May 2026 11:00:00 +1000

记录 Agent 配置 Playwright MCP 并换用 CloakBrowser 反检测浏览器的全过程，包括踩到的坑和 cookie 持久化方案。

.qmd 和 .md 的语法差异

nite@nite07.com (Nite) — Sat, 09 May 2026 10:00:00 +1000

介绍 Quarto .qmd 文件相较普通 .md 多出来的语法和使用场景。

Podman login 登录信息重启后失效的处理

nite@nite07.com (Nite) — Tue, 05 May 2026 13:00:00 +1000

记录 rootless Podman 默认 auth.json 放在临时目录导致重启后登录信息消失的问题，以及持久化 authfile 的配置方式。

自建邮局排查指南

nite@nite07.com (Nite) — Fri, 01 May 2026 13:00:00 +1000

本文整理自建邮件服务器中的通用排查思路，覆盖 DNS、端口、TLS、服务监听、客户端自动发现与本地网络干扰等常见问题。

PostgreSQL 18 Docker 升级：从 17 迁移

nite@nite07.com (Nite) — Fri, 01 May 2026 02:43:51 +0000

PostgreSQL 18 官方镜像将默认数据目录调整为带版本号的新路径。本文整理从 PostgreSQL 17 Docker/Podman 容器迁移到 18 的步骤，包括备份、重建容器、恢复数据和清理旧卷。

Quadlet 配置分享：Gitea

nite@nite07.com (Nite) — Wed, 29 Apr 2026 05:00:00 +1000

分享 Gitea Quadlet 配置，含 PostgreSQL + 可选 Runner。

Quadlet 配置分享：AxonHub

nite@nite07.com (Nite) — Wed, 29 Apr 2026 04:00:00 +1000

分享 AxonHub Quadlet 配置。

Hugo 多语言下 collection 名不同导致语言切换失效的解决方法

nite@nite07.com (Nite) — Wed, 29 Apr 2026 02:30:00 +1000

Hugo 的多语言站点中，中英文文章使用不同的 collection 名称时，collection 列表页和文章内的语言切换按钮会失效。

Quadlet 配置分享：Vaultwarden

nite@nite07.com (Nite) — Wed, 29 Apr 2026 01:10:00 +1000

分享 Vaultwarden Quadlet 配置。

Caddy + Hugo 实现基于 Accept-Language 的多语言智能跳转

nite@nite07.com (Nite) — Tue, 28 Apr 2026 21:00:00 +0800

本文详细介绍如何使用 Caddy 为 Hugo 静态站点实现基于浏览器 Accept-Language 的自动语言跳转，包括路径重定向、文件探测回退、语言优先级降级处理，以及完整的多语言站点配置方案。

Caddy WebDAV 配置：子路径挂载与权限控制

nite@nite07.com (Nite) — Tue, 28 Apr 2026 20:45:00 +0800

本文介绍如何在 Caddy 中配置 WebDAV 文件管理服务，包括子路径挂载、与 basic_auth 组合权限控制、路由优先级调整（order 指令），以及多个 WebDAV 使用场景的配置对比。

Caddy MaxMind GeoIP 地理访问限制：白名单与黑名单模式

nite@nite07.com (Nite) — Tue, 28 Apr 2026 20:15:00 +0800

本文介绍如何使用 Caddy 的 maxmind-geolocation 插件实现基于 IP 地理位置的白名单/黑名单访问控制，包括 GeoLite2 数据库的自动更新方案和两种限制模式的配置示例。

Caddy rate_limit 配置

nite@nite07.com (Nite) — Tue, 28 Apr 2026 20:00:00 +0800

本文介绍 Caddy rate_limit 插件的配置方法，包括限流区域的划分、key 选择、窗口参数调优，以及我在实际部署中的取舍考量——为什么最终选择注释掉这条规则。

Caddy Cloudflare DNS-01：获取通配符 TLS 证书

nite@nite07.com (Nite) — Tue, 28 Apr 2026 19:45:00 +0800

介绍如何用 Caddy 配合 Cloudflare DNS-01 自动获取通配符 TLS 证书，重点是 API Token 权限和全局 Caddyfile 配置，以及 Cloudflare 代理后的真实客户端 IP。

xcaddy 构建自定义 Caddy：插件选型到 CI/CD 自动发布

nite@nite07.com (Nite) — Tue, 28 Apr 2026 19:30:00 +0800

本文从零介绍如何使用 xcaddy 构建一个带插件的自定义 Caddy 镜像，包含每个插件的用途说明、多阶段构建的 Dockerfile 设计，以及通过 GitHub Actions 每周自动构建并推送到 Docker Hub 的完整 CI/CD 流程。

MinerU 低显存部署踩坑：hybrid OOM 而 vlm 反而能跑

nite@nite07.com (Nite) — Thu, 23 Apr 2026 16:30:00 +0800

记录在 8GB 显存显卡上部署 MinerU 时遇到的 hybrid-auto-engine OOM 问题，以及翻源码后发现 vlm-auto-engine 反而更省显存的原因和最终解决方案。

code-server 使用微软 VS Code 扩展商店

nite@nite07.com (Nite) — Mon, 13 Apr 2026 05:57:46 +1000

记录一下如何在 systemd 用户服务里为 code-server 设置 EXTENSIONS_GALLERY，并避开 systemd 对 % 和引号的坑。

Linux 下解决 Netbird 和 Mihomo(Tun Mode) 共存问题

nite@nite07.com (Nite) — Sat, 17 Jan 2026 16:50:52 +0800

本文介绍如何通过增加路由表规则解决，Netbird 和 Mihomo(Tun Mode) 一起使用时无法建立 p2p 连接的问题。

使用 Caddy 部署 Github 镜像

nite@nite07.com (Nite) — Fri, 05 Dec 2025 00:50:00 +0800

本文介绍如何 Caddy2 镜像 Github 网站以便在网络受限区域访问 Github

Stalwart SMTP 发件自动归档

nite@nite07.com (Nite) — Mon, 24 Nov 2025 17:56:00 +1100

如果你正在使用现代化的 Stalwart Mail Server，你可能已经注意到了一个经典的邮件架构痛点：

当你使用 Thunderbird 或 Outlook 等客户端发信时，已发送的邮件会乖乖躺在“已发送”文件夹里；但当你配置 通知机器人 (如 notification@example.com) 或 ERP 系统通过 SMTP 协议自动发信时，发件箱却空空如也。

为什么会这样？ 这是因为标准 SMTP 协议只负责“传输”，不负责“存储”。桌面客户端之所以能保存备份，是因为它们在发送后多做了一步 IMAP 上传操作。而简单的 SMTP 脚本通常不会做这一步。

为了解决这个问题，我们需要在服务端层面进行拦截和归档。本文将介绍一种最稳定、最符合 RFC 标准的解决方案——回环子地址重定向法 (Loopback Sub-addressing Strategy)。

核心原理：回环子地址重定向

在 Stalwart 中，直接在发送阶段使用 fileinto 写入文件往往会因为上下文权限问题导致失败或不可预测的后果。

Git includeIf 管理多个 Git 身份

nite@nite07.com (Nite) — Fri, 14 Nov 2025 15:50:00 +1100

同时维护工作项目和个人项目时，Git 身份很容易用错：公司项目里用了个人邮箱，开源项目里暴露了工作邮箱。手动切换 Git 配置很麻烦，也容易出错。

Git 的 includeIf 可以按条件自动加载不同配置文件，用来管理多套身份很合适。

为什么需要 includeIf？

在日常开发中，我们常常需要在不同的身份之间切换：

游戏资源站使用教程

nite@nite07.com (Nite) — Sat, 08 Nov 2025 00:10:00 +1100

你遇到大部分的问题应该都可以在这里找到答案，选择你需要的部分阅读。

1. 磁力资源下载教程

磁力链接是以 magnet:?xt=urn:btih: 开头的下载链接，需要通过 BT 客户端下载。

GPT-SoVITS：少样本语音克隆与 TTS

nite@nite07.com (Nite) — Thu, 06 Nov 2025 14:38:00 +1100

GPT-SoVITS 是一个先进的少样本语音克隆和文本转语音（TTS）工具，只需 1 分钟的参考音频即可实现高质量语音克隆。该项目由 RVC-Boss 团队开发，结合 GPT 语义建模和扩散声学建模技术，在开源社区中获得广泛关注。其核心优势在于极低的训练数据需求、跨语言语音生成能力以及用户友好的 WebUI 界面，使得专业级语音合成技术触手可及。

核心功能

GPT-SoVITS 的核心竞争力体现在其革命性的少样本学习能力上。传统语音克隆系统通常需要数小时的音频数据，而 GPT-SoVITS 仅需 1 分钟参考音频即可克隆声音，这一突破性特性源于其创新的两阶段生成架构。

MPV 播放远程视频时加载本地字幕

nite@nite07.com (Nite) — Thu, 04 Sep 2025 20:00:52 +1000

本文介绍如何通过修改 MPV 的启动参数，实现播放远程视频时加载本地字幕。

Podman Rootless 技巧：利用 --group-add keep-groups 解决卷组权限难题

nite@nite07.com (Nite) — Thu, 04 Sep 2025 14:30:52 +1000

本文介绍如何通过在启动容器时使用 --group-add keep-groups 参数，优雅地解决 Podman Rootless 模式下，容器内无法访问宿主机上通过组权限管理的目录的问题。

KDE 自用右键菜单文件

nite@nite07.com (Nite) — Thu, 04 Sep 2025 03:13:00 +1000

本文给出一些 Dolphin 自用右键菜单文件，供大家参考。

用 Gitolite 搭建你自己的私有 Git 服务器

nite@nite07.com (Nite) — Mon, 01 Sep 2025 19:45:00 +1000

本文介绍如何使用 Gitolite 创建 Git 服务器。

Jetbrains 系列软件一键激活教程

nite@nite07.com (Nite) — Sat, 09 Aug 2025 10:00:00 +1000

本文介绍如何一键激活 Jetbrains 系列软件。

在 WSL2(archlinux) 及 Podman 中启用 Nvidia GPU 加速

nite@nite07.com (Nite) — Wed, 23 Jul 2025 12:00:00 +0800

本文介绍如何在 WSL2 的 Arch Linux 环境中配置 Podman 以使用 Nvidia GPU 加速。

Podman 容器启动长时间等待：network-online.target 依赖问题

nite@nite07.com (Nite) — Mon, 21 Jul 2025 00:40:52 +0800

使用 Podman 和 Quadlet 管理的容器可能在启动时长时间卡住，问题通常与 systemd 的 network-online.target 未被激活有关。本文给出三种解决方案。

Podman 挂载目录 Permission denied：SELinux 导致的一个坑

nite@nite07.com (Nite) — Sun, 20 Jul 2025 18:40:52 +0800

使用 Podman 挂载主机目录到容器时，即使容器内为 root 用户也可能遇到 Permission denied。本文分析 SELinux 安全机制对容器访问的影响，并给出解决方案。

使用 Caddy 容器和 Cgit 展示 git 仓库

nite@nite07.com (Nite) — Sun, 20 Jul 2025 15:45:00 +0800

本篇教程是在 “使用 Caddy 和容器轻松搭建你的私有 Git 服务器” 基础上的进阶。为已有的 Git 服务器集成 cgit，从而提供一个功能丰富的 Web 界面来浏览仓库。

设置 Midnight Commander 双击打开文件

nite@nite07.com (Nite) — Sat, 19 Jul 2025 14:30:52 +0800

本文介绍如何通过修改 Midnight Commander (mc) 的配置，实现双击或回车时用自定义编辑器（如 $EDITOR）打开文件，提升文件管理效率。

Podman Quadlet 入门：把容器交给 Systemd 管理

nite@nite07.com (Nite) — Sat, 19 Jul 2025 10:10:52 +1000

本文介绍 Podman Quadlet 的基础知识：什么是 Quadlet、它的文件类型和结构、如何编写简单的 .container 和 .pod 文件，以及如何通过 Systemd 管理容器生命周期。

Git GPG 密钥生成与迁移

nite@nite07.com (Nite) — Sat, 19 Jul 2025 00:31:00 +0800

本文详细介绍如何生成和迁移 GPG 密钥，助你在多台设备上实现 Git 提交签名，轻松获得 GitHub “Verified” 徽章。

用 Caddy 和容器搭建 Git over HTTPS 服务器

nite@nite07.com (Nite) — Fri, 18 Jul 2025 11:45:00 +0800

本文介绍如何使用 Caddy2 和容器快速搭建一个支持 HTTPS 和基本认证的轻量级私有 Git 服务器，适合不需要完整 GitLab/Gitea 的场景，配置简单、安全高效，适合个人或小团队自建代码托管平台。

Syncthing 将普通客户端作为中继节点

nite@nite07.com (Nite) — Thu, 17 Jul 2025 03:20:52 +0800

介绍一种更简单的 Syncthing 多设备同步方案：不自建发现和中继服务器，而是在常在线设备上运行标准 Syncthing 客户端。

异地同步看片：Alist/Openlist/Rclone + Syncplay

nite@nite07.com (Nite) — Thu, 17 Jul 2025 02:44:52 +0800

用 Alist/Openlist/Rclone 生成网盘直链，再配合 Syncplay 实现异地同步观影。

Windows Tailscale 启用 socks5 代理

nite@nite07.com (Nite) — Wed, 16 Jul 2025 12:19:00 +0800

本文介绍如何在 Windows 系统下，通过修改 Tailscale 服务启动参数，启用 Userspace Networking 模式和内置 SOCKS5 代理，实现按需为特定应用程序提供 Tailscale 网络代理，避免全局流量劫持，提升使用灵活性

使用 Sunshine、Moonlight 和 Virtual-Display-Driver 将闲置设备变为 Windows 扩展屏

nite@nite07.com (Nite) — Thu, 05 Jun 2025 05:10:00 +1000

通过 Virtual-Display-Driver 创建虚拟显示器，结合 Sunshine 串流服务器和 Moonlight 客户端，将 Android 手机、平板等闲置设备变成 Windows 电脑的无线扩展屏幕。本教程详细介绍三个工具的配置步骤，实现同一局域网下的高效屏幕扩展方案。

Arch Linux 使用 Xbox 手柄

nite@nite07.com (Nite) — Sun, 15 Dec 2024 00:22:52 +0800

记录一下在 Arch Linux 下通过 USB、蓝牙和 Xbox 无线适配器连接 Xbox 手柄的常见做法。

Steam 游戏破解工具

nite@nite07.com (Nite) — Fri, 13 Dec 2024 00:45:52 +0800

游戏破解

GBE FORK

https://github.com/Detanup01/gbe_fork

Linux Sing-box 与 Tailscale 并存问题

nite@nite07.com (Nite) — Mon, 09 Dec 2024 20:00:00 +0800

问题描述

在使用 Sing-box 时，Tailscale 客户端无法正常工作。在其他设备可以通过 tailscale ping <ip/hostname> ping 通主机，但是无法建立连接(例如 ssh 会显示 Connection refused)。

Archlinux 下运行盗版游戏(exe)、online-fix 以及游戏文件获取

nite@nite07.com (Nite) — Wed, 27 Nov 2024 23:22:52 +0800

以 Archlinux 为例，其他发行版请自行调整命令。

0. (可选)安装 proton-ge-custom

GE-Custom 相较于官方版本有以下优势：

Archlinux Clevo(蓝天) 笔记本驱动以及控制中心安装

nite@nite07.com (Nite) — Sun, 03 Nov 2024 11:45:52 +0800

Clevo 电脑的风扇调度真的是吵得要死，之前一直用 Windows 系统，用 Ryzen Master 降压来控制 CPU 温度，间接降低转速。现在换到 Linux 系统，不好好配置一下实在受不了。我在 Google 上翻了半天，找到了一堆 Github 仓库，试了几个都不好用，最后发现 AUR 仓库里已经有大佬整理了好用的包(我太爱 pacman 和 aur 了！)。 https://aur.archlinux.org/packages?K=clevo

安装驱动

yay -S clevo-drivers-dkms-git

GO sync.Once 使用

nite@nite07.com (Nite) — Fri, 25 Oct 2024 03:10:52 +0800

sync.Once 用于确保某个函数只执行一次，无论有多少个 goroutine 尝试执行它。它有一个方法 Do(f func())，传入需要执行的函数。

基本用法示例：

package main

import (
    "fmt"
    "sync"
)

func main() {
    var once sync.Once
    done := make(chan bool)

    // 模拟多个 goroutine 调用
    for i := 0; i < 10; i++ {
        go func(x int) {
            // once.Do() 传入的函数只会执行一次
            once.Do(func() {
                fmt.Printf("只执行一次: %d\n", x)
            })
            // 这行每个 goroutine 都会执行
            fmt.Printf("goroutine %d 完成\n", x)
            done <- true
        }(i)
    }

    // 等待所有 goroutine 完成
    for i := 0; i < 10; i++ {
        <-done
    }
}

常见使用场景：

Archlinux Rdp 连接问题

nite@nite07.com (Nite) — Sun, 20 Oct 2024 16:45:52 +0800

如果你在非 Windows 端使用 RDP 协议远程控制一台登录微软账号的 Windows，那么连接时输入的用户名可能不是你的微软账号(邮箱)，也不是去掉邮箱后缀后的剩余部分，更不是 Administrator，而是其他值，可以在被控端执行 echo %USERNAME% 查看，这个值虽然是自己设置的，但是系统设置里完全找不到，我试了半天真是有被气到。

Archlinux Wayland 输入法问题

nite@nite07.com (Nite) — Sat, 19 Oct 2024 01:22:52 +0800

fcitx5 输入法不可用

在桌面环境的设置中设置虚拟键盘为 fcitx 5

Archlinux 中 Nvidia 驱动导致的 KDE Plasma 相关问题

nite@nite07.com (Nite) — Sat, 19 Oct 2024 01:22:52 +0800

本文针对 Turing (NV160/TUXXX) 及之后型号的显卡，可以通过 lspci -k | grep -A 2 -E "(VGA|3D)" 查看显卡型号

在 Linux 平台下 Nvidia 的驱动分为 3 种

nvidia/nvidia-dkms Nvidia 官方闭源驱动
nvidia-open/nvidia-open-dkms Nvidia 官方半开源驱动
nouveau 第三方开源驱动

官方驱动不论是闭源还是半开源，在游戏方面的性能都远好于第三方开源驱动。带有 dkms 后缀的版本与不带的版本区别在于，不带后缀的版本用于 linux 标准内核，而带后缀的版本用于其他内核。

问题及解决方案

官方内核

在驱动更新到 555 主版本号之后会出现 KDE Plasma 动画卡顿和掉帧的情况，这是由于 Nvidia 官方引入的 GSP(RISC-V 处理器) 不稳定导致的。在目前的驱动版本(560)中该问题仍然存在，可以通过禁用 GSP 解决，但是只有闭源驱动可以禁用 GSP，半开源驱动无法实现。