晴雨笔记

Anubis 配置安装指南：为你的网站加上 PoW 护盾

2026-08-21T05:30:00.000Z

Anubis 是一个通过工作量证明来防御 AI 爬虫的开源工具。如果你正在寻找它的安装方法，这篇教程就是为你准备的。

安装方式#

这只是我的安装方式，你也可以选择其他方式安装

创建相关文件/文件夹并设置权限

1
mkdir -p ~/anubis/{anubis-data}
2
cd ~/anubis
3
openssl rand -hex 32 > anubis.key
4
touch botPolicy.yaml docker-compose.yml
5
chowm -R 1000:1000 anubis-data anubis.key
6
chmod 600 anubis.key
7
chmod -R 700 anubis-data
8
chmod 755 botPolicy.yaml

编写Anubus相关配置文件#

botPolicy.yaml展开收起

1
# ============================================
2
# 机器人规则配置
3
# ============================================
4
bots:
5
  - name: example-rule          # 规则名称（示例规则）
6
    user_agent_regex: ".*bot.*" # 匹配User-Agent中包含"bot"的请求（不区分大小写）
7
    action: DENY                # 对该类请求执行的操作：DENY（拒绝访问）
8

9
# ============================================
10
# 数据存储配置
11
# ============================================
12
store:
13
  backend: bbolt                # 使用bbolt作为后端存储（嵌入式键值数据库）
14
  parameters:
15
    path: /data/anubis.bdb     # 数据库文件存储路径（持久化数据）
16

17
# ============================================
18
# 挑战阈值规则配置
19
# ============================================
20
thresholds:
21
  - name: challenge-everyone    # 规则名称：对所有用户进行挑战
22
    expression:                 # 触发条件表达式
23
      all:                      # 所有条件都必须满足（逻辑与）
24
        - weight >= 0          # 权重大于等于0（实际上所有请求都满足）
25
    action: CHALLENGE          # 触发动作：CHALLENGE（发起挑战验证）
26
    challenge:
27
      algorithm: fast          # 挑战算法：fast（快速哈希计算）
28
      difficulty: 5            # 难度级别：5（数值越高计算越复杂，建议范围3-6）
29

30
# ============================================
31
# 日志配置
32
# ============================================
33
logging:
34
  sink: stdio                  # 日志输出目标：stdio（标准输入输出，控制台）
35
  level: INFO                  # 日志级别：INFO（信息级，记录一般操作信息）
36

37
# ============================================
38
# HTTP状态码配置
39
# ============================================
40
status_codes:
41
  CHALLENGE: 200               # 挑战响应状态码：200（正常响应，页面包含挑战内容）
42
  DENY: 403                    # 拒绝响应状态码：403（禁止访问）
43

44
# ============================================
45
# DNS黑名单配置
46
# ============================================
47
dnsbl: false                   # DNS黑名单功能：禁用（false表示不启用DNSBL检查）
48

49
# ============================================
50
# DNS缓存TTL配置
51
# ============================================
52
dns_ttl:
53
  forward: 300                 # 正向DNS解析缓存时间：300秒（5分钟）
54
  reverse: 300                 # 反向DNS解析缓存时间：300秒（5分钟）
55

56
# ============================================
57
# Open Graph元标签配置
58
# ============================================
59
openGraph:
60
  enabled: false               # Open Graph支持：禁用（不生成OG元标签，用于社交媒体分享）

展开收起

docker-compose.yml展开收起

1
services:
2
  anubis:
3
    image: ghcr.io/techarohq/anubis:latest
4
    container_name: anubis
5
    environment:
6
      BIND: ":8923"
7
      TARGET: " "
8
      POLICY_FNAME: "/config/botPolicy.yaml"
9
      ED25519_PRIVATE_KEY_HEX_FILE: "/secrets/anubis.key"
10
      SLOG_LEVEL: "INFO"
11
      AUTH_REQUEST_MODE: "true"
12
    healthcheck:
13
      test: ["CMD", "anubis", "--healthcheck"]
14
      interval: 5s
15
      timeout: 30s
16
      retries: 5
17
      start_period: 500ms
18
    volumes:
19
      - "./botPolicy.yaml:/config/botPolicy.yaml:ro"
20
      - "./anubis.key:/secrets/anubis.key:ro"
21
      - "./anubis-data:/data"
22
    networks:
23
      - 1panel-network
24
    restart: unless-stopped
25

26
networks:
27
  1panel-network:
28
    external: true

展开收起

配置 Nginx，添加相关配置项#

nginx.conf展开收起


8 collapsed lines
1
server {
2
    listen 80 ;
3
    listen 443 ssl ;
4
    server_name xomu.ren;
5
    index index.php index.html index.htm default.php default.htm default.html;
6
    access_log /www/sites/xomu.ren/log/access.log main;
7
    error_log /www/sites/xomu.ren/log/error.log;
8

9
    location /.within.website/ {
10
        proxy_pass http://anubis:8923; # 需要确保 nginx 和 docker 在同一网络
11
        proxy_set_header X-Real-IP $remote_addr;
12
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
13
        proxy_set_header Host $host;
14
        proxy_pass_request_body off;
15
        proxy_set_header Content-Length "";
16
        auth_request off;
17
    }
12 collapsed lines
18

19
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.env|\.svn|\.project|LICENSE|README.md) {
20
        return 404;
21
    }
22
    location ^~ /.well-known/acme-challenge {
23
        allow all;
24
        root /usr/share/nginx/html;
25
    }
26
    if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) {
27
        return 403;
28
    }
29

30
    location @redirect_to_anubis {
31
        return 307 /.within.website/?redir=$scheme://$host$request_uri;
32
        auth_request off;
33
    }
34
    location / {
35
        auth_request /.within.website/x/cmd/anubis/api/check;
36
        error_page 401 403 = @redirect_to_anubis;
37
    }
17 collapsed lines
38
    root /www/sites/xomu.ren/index;
39
    error_page 404 /404.html;
40
    http2 on;
41
    if ($scheme = http) {
42
        return 301 https://$host$request_uri;
43
    }
44
    ssl_certificate /www/sites/xomu.ren/ssl/fullchain.pem;
45
    ssl_certificate_key /www/sites/xomu.ren/ssl/privkey.pem;
46
    ssl_protocols TLSv1.3 TLSv1.2;
47
    ssl_ciphers ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:!aNULL:!eNULL:!EXPORT:!DSS:!DES:!RC4:!3DES:!MD5:!PSK:!KRB5:!SRP:!CAMELLIA:!SEED;
48
    ssl_prefer_server_ciphers off;
49
    ssl_session_cache shared:SSL:10m;
50
    ssl_session_timeout 10m;
51
    error_page 497 https://$host$request_uri;
52
    proxy_set_header X-Forwarded-Proto https;
53
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains";
54
}

展开收起

启动服务#

Terminal window

1
docker compose up -d # 启动 Anubis
2
docker restart nginx # 重启 Nginx

运行效果

Vibe Coding 实战：用 AI 从零写了一个短链接平台

2026-05-23T07:39:33.000Z

最近 Vibe Coding 挺火的，我也试了一把——把需求写成完整的 prompt 丢给 AI，让它从零写了一个短链接服务平台。

项目是逐步长起来的：先给 AI 一份核心需求的 prompt 做一版，然后不断提新需求让 AI 迭代。看 Git 提交记录就能看出来这个演进过程。

记录一下我用的 prompt 原文、后续加了哪些功能、以及测试中踩的坑。

项目开源地址：GitHub · Gitee

初始 prompt#

以下是第一批发给 AI 的完整内容：

你是全栈开发工程师，精通 Nextjs 框架，请完成以下任务：

在项目中添加 Radix-UI 框架

实现 Nextjs 后端，连接 PostgreSQL 数据库

实现多用户管理（多个管理员和用户，管理员可以精确管理每个用户创建的短网址）

实现创建短网址功能，支持设置有效期（n小时/n天/n月/n年），或者年月日时分秒，永久（设计为用户权限）

实现短网址的密码保护功能，输入正确的授权码才能访问（随机生成 6 位纯数字密码）或者设定文本密码，默认随机生成 6 位密码，或者无密码

实现过期的短网址自动清理（兼容 Serverless，管理员可关闭）

暴露 API 接入功能，用户可以通过 token 验证来接入短网址生成，管理员可控制用户权限

仅管理员可创建用户，限制至少保留一个管理员账户

要求：

用户界面美观，使用 Radix-UI 框架

保持 UI 框架原有的样式，CSS 只用于控制布局而不是样式，实现夜间/日间模式

代码合理分文件，代码注释合理，方便人工阅读和维护

完成后编写 README.md 文件

用户界面中不使用 Emoji 等表情，一律使用字体图标替代

事项：

已安装好 PostgreSQL 在 Podman 中，可以通过 172.20.1.5<5432> 连接

数据库操作请使用 podman exec

项目测试请创建使用 shorturl 用户/数据库

使用 Prisma.js 连接数据库，方便后期添加其他数据库支持

编写 package.json 中的运行命令，快速创建数据库相关内容

编写打包并运行的 package.json script 指令

AI 基于这份 prompt 生成了项目骨架：数据模型、认证系统、短链接核心 CRUD、管理后台、Docker 部署。Git 记录上看大概是这几个提交：

1
7458a3e  初始化项目结构和数据库模型
2
6653133  添加 Radix-UI 组件库和主题系统
3
8c2a559  实现用户认证系统
4
59d7555  实现短链接核心功能
5
caa69ee  添加管理后台和系统功能
6
d5d2372  添加 Docker 支持和文档

后面陆续加的功能#

第一版跑起来之后，我又陆续给 AI 提了新需求，功能是一步步叠加上去的：

多域名支持 — 同一个短码在不同域名下独立，互不干扰。还加了域名级别的 HTTPS 开关。

IP 地理定位 — 访问记录里显示访客所在省份。用的离线 IP 库，不调外部接口。

安全审计日志 — 在 middleware 里无侵入记录每次请求，格式对标 ISO 27001。

API Key 加密存储 — 密钥用 AES-256-GCM 加密，查库用 SHA-256 哈希，不是明文存。

SQLite 支持 — 后期加的，entrypoint 脚本根据环境变量自动切换 PostgreSQL 或 SQLite，方便不同场景部署。

分页系统 — 链接列表和用户列表支持分页，可调每页条数。

复制模板 — 管理员可以写 JS 模板函数，自定义复制短链接时的格式。

看 Git 记录，项目从第一个核心功能到现在的完整状态，经历了 50+ 次提交，大部分都是「提需求 → AI 实现 → 测试验证 → 有问题再修」的循环。

踩的坑#

测试过程中发现的主要问题：

访问次数为 0 还能用 — 创建短链接时设了访问次数上限，用完后依然能正常跳转。把测试现象告诉 AI，它自己定位修了。

Docker 构建原生模块报错 — ts-ip2region2 依赖 C++ 编译，构建环境和运行环境不一致导致 .node 文件缺失。折腾了几轮才在 Dockerfile 里正确处理好预编译产物的复制。

有效期解析边界 — 某些格式的过期时间解析不对，测试发现后让 AI 修了。

SQLite 兼容性问题 — 后期加 SQLite 支持时，Prisma 的 enum 类型在 SQLite 里不支持，需要改成 string 类型，还有一些查询语法差异，逐个修了。

环境差异 — AI 的开发环境和 Docker 构建环境不一致，Node 版本、系统库不同导致各种小问题，反复对齐。

一点感受#

这次试下来最大的体会是：Vibe Coding 不是一次性把需求说清楚就完事了，项目是长出来的。

初始 prompt 决定了项目骨架，后续迭代才是血肉。每加一个功能，就是一段「提需求 → AI 实现 → 测试验证」的小循环。50 多次提交看下来，AI 写代码的效率确实高，但需求分解、功能设计、测试验证这些事还是得人来做。

写 prompt 本身就是在做架构设计——选什么技术栈、功能怎么拆、约束条件是什么，这些不想清楚，AI 也帮不了你。

网上常看到「文科生用 AI 也能做软件」的说法，好像不需要任何专业知识就能做出产品。但我的实际体验是：你不会因为有了 AI 就突然会做软件，你只是把写代码的活儿外包了而已。需求分析、功能设计、测试验证、部署运维，这些环节一个都少不了。不会因为你用了 AI，产品需求就能自动变清晰，bug 就能自动消失，部署就能一次成功。

AI 降低了写代码的门槛，但没有降低做产品的门槛。

Astro & Fuwari优化配置

2025-09-21T06:31:06.000Z

Twikoo评论区 💬#

具体后端部署请参考 Twikoo 哦～我给相关代码添加了两个响应事件，解决了需要刷新一次才能显示的小问题呢！😊

新增编辑相关文件

src/components/Comment.astro展开收起

1
<div id="tcomment"></div>
2

3
<script is:inline>
4
  window.twikooIsRun = false;
5

6
  function loadTwikoo() {
19 collapsed lines
7
    if (window.twikooIsRun) return;
8
    const commentsContainer = document.getElementById("tcomment");
9
    if (commentsContainer) {
10
      const script = document.createElement("script");
11
      script.src =
12
        "https://registry.npmmirror.com/twikoo/1.6.44/files/dist/twikoo.min.js";
13
      script.onload = () => {
14
        const initScript = document.createElement("script");
15
        initScript.innerHTML = `
16
            twikoo.init({
17
                envId: 'https://xxx',
18
                el: '#tcomment',
19
            });
20
        `;
21
        document.body.appendChild(initScript);
22
        window.twikooIsRun = true;
23
      };
24
      document.body.appendChild(script);
25
    }
26
  }
27
  document.addEventListener("astro:page-load", loadTwikoo);
28
  document.addEventListener("DOMContentLoaded", loadTwikoo);
29
</script>

展开收起

添加到喜欢的位置，比如我底部的评论区就很合适呀～

src/pages/posts/[...slug].astro展开收起

1
---
2
import Comment from "@components/Comment.astro";
3
---
4
...
5
<Markdown class="mb-6 markdown-content onload-animation">
6
  <Content />
7
</Markdown>
8
{
8 collapsed lines
9
  licenseConfig.enable && (
10
    <License
11
      title={entry.data.title}
12
      slug={entry.slug}
13
      pubDate={entry.data.published}
14
      class="mb-6 rounded-xl license-container onload-animation"
15
    />
16
  )
17
}
18

19
<Comment />

展开收起

底部计时功能 ⏳#

实时显示本站运行时长哦～是不是很贴心！💕

添加配置项

src/types/config.ts

1
export type SiteConfig = {
2
  date: Date
3
};

src/config.ts

1
export const siteConfig: SiteConfig = {
2
  date: new Date('2020-04-15 00:00:00')
3
};

需要新增以下文件

src/components/RunningTime.svelte展开收起

1
<script>
2
import { siteConfig } from '@/config';
3

4
let days, hours, minutes, seconds;
5

6
function updateEstablishedTime() {
7 collapsed lines
7
  var now = new Date();
8
  var difference = now.getTime() - siteConfig.date.getTime();
9
  days = Math.floor(difference / (1000 * 60 * 60 * 24));
10
  hours = Math.floor((difference % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
11
  minutes = Math.floor((difference % (1000 * 60 * 60)) / (1000 * 60));
12
  seconds = Math.floor((difference % (1000 * 60)) / 1000);
13
  setTimeout(updateEstablishedTime, 1000);
14
}
15

16
updateEstablishedTime();
17
</script>
18

19
<span>
20
  本站已稳定运行 {days} 天 {hours} 小时 {minutes} 分钟 {seconds} 秒
21
</span>

展开收起

在网站底部引用相关文件就好啦～

src/components/Footer.astro

1
---
2
import { Icon } from "astro-icon/components";
3
import RunningTime from "./RunningTime.svelte";
4
---
5
<div class="transition text-50 text-sm text-center">
3 collapsed lines
6
  &copy; <span id="copyright-year">{currentYear}</span> {profileConfig.name}. All Rights Reserved. /
7
  <a class="transition link text-[var(--primary)] font-medium" target="_blank" href={url('rss.xml')}>RSS</a> /
8
  <a class="transition link text-[var(--primary)] font-medium" target="_blank" href={url('sitemap-index.xml')}>Sitemap</a><br>
9
  <div class="flex items-center justify-center gap-1"><Icon name='fa6-solid:heart' class="text-[0.8rem] text-red-500 animate-pulse"></Icon><RunningTiclient:load /></div>
3 collapsed lines
10
  Powered by
11
  <a class="transition link text-[var(--primary)] font-medium" target="_blank" href="https://astro.build">Astro</a> &
12
  <a class="transition link text-[var(--primary)] font-medium" target="_blank" href="https://github.com/saicaca/fuwari">Fuwari</a>
13
</div>

Arch Linux UEFI 安装指南：Btrfs 子卷 + GNOME 桌面环境

2025-05-26T14:37:35.000Z

声明：原作者信息

哔哩哔哩主页：https://space.bilibili.com/2017026819
Github主页：https://github.com/FireflyAyaka
QQ号：2037566388

温馨提示：本教程仅适用于UEFI设备 (包括虚拟机模拟UEFI或真机UEFI)。使用传统BIOS(Legacy)设备的，出门左拐，找其他教程去

🎒 准备开始#

需要准备的东西#

最新版的Arch Linux ISO镜像文件
一个U盘(如果你要在实体机安装的话)

重要注意事项#

✨ 安全小贴士 ✨

备份好所有重要数据
操作有风险，三思而后行
如果是第一次尝试，强烈建议先在虚拟机里练习

🖥️ 启动Live环境#

启动方式选择#

使用虚拟机：直接加载下载好的ISO镜像启动
使用实体机：需要用工具把ISO写入U盘后从U盘启动

💾 一、磁盘分区与配置#

1. 使用cfdisk分区工具#

Terminal window

1
cfdisk /dev/sda

分区步骤详解#

初始化磁盘格式：选择 gpt 选项
创建EFI系统分区：
- 大小设置为500M
- 类型选 EFI System
创建根分区：
- 使用剩下的所有空间
- 类型选择 Linux root (x86-64)

分区表示例#

1
Disk: /dev/sda
2
Size: 64GiB
3
Label: gpt
4
Device    Start   End       Size  Type
5
/dev/sda1 2048    1026047   500M  EFI System
6
/dev/sda2 1026048 134215679 63.5G Linux root (x86-64)

选择Write写入分区表输入yes确认写入选择quit退出程序

2. 格式化分区操作#

Terminal window

1
# 格式化EFI分区为FAT32格式
2
mkfs.fat -F32 -n "arch-efi" /dev/sda1
3

4
# 格式化根分区为Btrfs格式
5
mkfs.btrfs -L "arch-root" /dev/sda2

3. Btrfs子卷设置#

Terminal window

1
# 先挂载根分区
2
mount /dev/sda2 /mnt
3

4
# 创建必要的子卷
5
btrfs subvolume create /mnt/@            # 根目录子卷
6
btrfs subvolume create /mnt/@home        # 用户目录子卷
7

8
# 临时卸载
9
umount /mnt

4. 创建挂载点结构（请在挂载@子卷后执行）#

Terminal window

1
# 创建必要的目录结构
2
mkdir -p /mnt/{boot/efi,home}
3

4
# 挂载EFI分区
5
mount /dev/sda1 /mnt/boot/efi

5. 分情况挂载磁盘#

根据你的硬件配置选择并执行合适的挂载命令：

实体机（SSD，2017年及以后的CPU）：

Terminal window

1
mount -o subvol=@,compress=zstd:3,noatime,ssd /dev/sda2 /mnt # 挂载主卷
2
mount -o subvol=@home,compress=zstd:4,noatime,ssd /dev/sda2 /mnt/home # 挂载用户卷

实体机（SSD，2016年及以前的CPU）：

Terminal window

1
mount -o subvol=@,compress=zstd:2,noatime,ssd /dev/sda2 /mnt # 挂载主卷
2
mount -o subvol=@home,compress=zstd:3,noatime,ssd /dev/sda2 /mnt/home # 挂载用户卷

虚拟机（虚拟磁盘文件存放在SSD，注意不是虚拟磁盘模拟SSD！）：

Terminal window

1
mount -o subvol=@,compress=zstd:1,noatime,ssd /dev/sda2 /mnt # 挂载主卷
2
mount -o subvol=@home,compress=zstd:2,noatime,ssd /dev/sda2 /mnt/home # 挂载用户卷

HDD（实体机HDD/虚拟磁盘文件存放在HDD）：

Terminal window

1
mount -o subvol=@,compress=lzo,noatime /dev/sda2 /mnt # 挂载主卷
2
mount -o subvol=@home,compress=lzo,noatime /dev/sda2 /mnt/home # 挂载用户卷

不确定CPU发布年份，但只确定使用SSD（实体机SSD/虚拟磁盘文件存放在SSD）：

Terminal window

1
mount -o subvol=@,compress=auto,noatime,ssd /dev/sda2 /mnt # 挂载主卷
2
mount -o subvol=@home,compress=auto,noatime,ssd /dev/sda2 /mnt/home # 挂载用户卷

不确定CPU发布年份，但只确定使用HDD（实体机HDD/虚拟磁盘文件存放在HDD）或完全不确定：

Terminal window

1
mount -o subvol=@,compress=auto,noatime /dev/sda2 /mnt # 挂载主卷
2
mount -o subvol=@home,compress=auto,noatime /dev/sda2 /mnt/home # 挂载用户卷

📦 二、安装基础系统#

1. 配置pacman#

Terminal window

1
nano /etc/pacman.conf

找到并取消注释 Color
在下面添加 ILoveCandy
在文件末尾添加以下内容：\

1
[archlinuxcn]
2
Server = https://mirrors.163.com/archlinux-cn/$arch

必做！ 不加这个到时候你pacstrap装不了paru！（paru相关详见Q&A）
完事后保存，然后添加archlinuxcn密钥：

Terminal window

1
pacman-key --lsign-key 'farseerfc@archlinux.org'
2
pacman -Sy archlinuxcn-keyring

（拍桌）重要操作！ 这一步相当于给软件源上一把锁，不做的话后面装软件会报错到怀疑人生～

2. 使用国内镜像加速#

Terminal window

1
# 设置镜像源
2
echo 'Server = https://mirrors.jxust.edu.cn/archlinux/$repo/os/$arch' > /etc/pacman.d/mirrorlist # 江西理工大学是一个很快的镜像源，比隔壁北外都快（北外最近开始限速了）
3
echo 'Server = https://mirrors.163.com/archlinux/$repo/os/$arch' >> /etc/pacman.d/mirrorlist # 可选，添加该备用源后可在江西理工大学镜像源不可用时让冈门替补
4

5
# 刷新软件包数据库
6
pacman -Syy

3. 安装基本系统#

Terminal window

1
pacstrap /mnt base base-devel linux-zen linux-zen-headers linux-firmware htop cpupower nano dhcpcd net-tools networkmanager iw wpa_supplicant bluez bluez-utils grub efibootmgr sudo doas snapper fastfetch paru # 这里paru来自archlinuxcn源

⚙️ 三、系统基础配置#

1. 生成fstab#

Terminal window

1
genfstab -U /mnt >> /mnt/etc/fstab

2. 进入新系统环境#

Terminal window

1
arch-chroot /mnt

3. 本地化设置#

Terminal window

1
# 设置中文locale
2
nano /etc/locale.gen  # 取消注释 zh_CN.UTF-8 UTF-8
3
locale-gen
4

5
# 设置默认语言
6
echo LANG=zh_CN.UTF-8 > /etc/locale.conf
7

8
# 设置时区
9
ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime # 这里没有北京，只有上海～
10

11
# 同步硬件时钟
12
hwclock --systohc --utc

4. 网络相关配置#

Terminal window

1
# 设置主机名(示例主机名ayaka，因为原作者是个绫华厨！可以改成你喜欢的名字)
2
echo ayaka > /etc/hostname
3

4
# 启用网络服务
5
systemctl enable dhcpcd # DHCP
6
systemctl enable NetworkManager # WiFi和有线
7
systemctl enable bluetooth  # 蓝牙

5. 用户账户管理#

Terminal window

1
# 设置root密码
2
passwd root
3

4
# 创建普通用户(示例用户名为firefly，因为原作者也是个流萤厨！可以改成你喜欢的名字)
5
useradd -m -g users -G wheel -s /bin/bash firefly
6

7
# 设置用户密码(记得将“firefly”改为你的用户名)
8
passwd firefly

6. 配置sudo和doas#

配置sudo：

Terminal window

1
EDITOR=nano visudo

在文件末尾添加以下内容（记得将“firefly”改为你的用户名）：

1
%wheel ALL=(ALL:ALL) ALL
2
%sudo ALL=(ALL:ALL) ALL
3
firefly ALL=(ALL:ALL) ALL
4
Defaults pwfeedback

配置doas（双重保险！不加这个到时候sudo炸了你就老实了）：

Terminal window

1
nano /etc/doas.conf

添加以下内容（记得将“firefly”改为你的用户名）：

1
permit persist keepenv setenv { -ENV LANG=zh_CN.UTF-8 } root as root
2
permit persist keepenv setenv { -ENV LANG=zh_CN.UTF-8 } :wheel as root
3
permit persist keepenv setenv { -ENV LANG=zh_CN.UTF-8 } :sudo as root
4
permit persist keepenv setenv { -ENV LANG=zh_CN.UTF-8 } firefly as root

7. 安装引导程序#

Terminal window

1
# 安装GRUB引导
2
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id='Arch Linux'
3

4
# 生成GRUB配置
5
grub-mkconfig -o /boot/grub/grub.cfg
6

7
# 生成initramfs
8
echo 'HOOKS=(base udev autodetect microcode modconf kms keyboard keymap consolefont block filesystems btrfs fsck)' >> /etc/mkinitcpio.conf
9
mkinitcpio -p linux-zen

8. 完成安装，准备重启#

Terminal window

1
# 退出chroot环境
2
exit
3

4
# 卸载所有分区
5
umount -R /mnt
6

7
# 重启进入新系统
8
reboot

🖥️ 四、安装图形界面#

1. 登录新系统#

使用之前设置的用户名和密码登录tty终端，随后输入以下命令并回车：

Terminal window

1
LANG=C

2. 配置pacman#

Terminal window

1
sudo nano /etc/pacman.conf

找到并取消注释 Color
在下面添加 ILoveCandy
在文件末尾添加以下内容：

1
[archlinuxcn]
2
Server = https://mirrors.163.com/archlinux-cn/$arch

必做！ 不做这一步你到时候没法更新paru！完事后保存，然后添加archlinuxcn密钥：

Terminal window

1
sudo pacman-key --lsign-key 'farseerfc@archlinux.org'
2
paru -Sy archlinuxcn-keyring

（拍桌）重要操作！ 这一步相当于给软件源上一把锁，不做的话后面装软件会报错到怀疑人生～

3. 使用国内镜像加速#

Terminal window

1
# 设置镜像源
2
echo 'Server = https://mirrors.jxust.edu.cn/archlinux/$repo/os/$arch' | sudo tee /etc/pacman.d/mirrorlist
3
echo 'Server = https://mirrors.163.com/archlinux/$repo/os/$arch' | sudo tee -a /etc/pacman.d/mirrorlist
4

5
# 刷新软件包数据库
6
paru -Syy

4. 安装GNOME桌面环境、中文输入法和常用软件#

Terminal window

1
paru -Sy --needed xorg gnome gnome-tweaks ptyxis gnome-nettool gnome-usage adwaita-icon-theme xdg-user-dirs-gtk fwupd gdm ibus ibus-libpinyin qt5ct qt6ct wps-office wps-office-fonts ttf-wps-win10 waterfox-bin vlc wqy-microhei adw-gtk-theme # 其中waterfox、wps-office、wps-office-fonts和ttf-wps-win10是AUR软件，这里我们用bin是为了加快安装速度；注意wps-office、wps-office-fonts和ttf-wps-win10没有bin
2
paru -R epiphany # 顺便淦掉GNOME自带的难用的浏览器
3
echo 'export QT_QPA_PLATFORMTHEME=qt5ct' | tee -a ~/.xprofile | tee -a ~/.profile | tee -a ~/.bashrc # 设置Qt优化工具

5. 字体缓存重建#

Terminal window

1
sudo fc-cache -fv

6. 启用显示管理器并重启#

Terminal window

1
sudo systemctl enable gdm
2
sudo reboot

🎉 四、大功告成#

恭喜你！现在可以享受你的Arch Linux系统啦！(ﾉ◕ヮ◕)ﾉ*:･ﾟ✧

小提示： 第一次进入GNOME桌面时，别忘了点击”进行导览”看看新手教程哦～
配置输入法： 打开GNOME设置 → 键盘 → 添加输入源 → 中文 → 汉语（智能拼音） → 将“汉语（智能拼音）”放在第一位

🔙 五、Snapper使用教程#

1. Snapper是什么？#

Snapper是一款用于Linux系统的系统备份和恢复工具，它能创建系统快照，就像给系统拍了一张张“照片”。在系统出现问题时（比如软件冲突导致无法启动、错误配置影响使用等情况），能将系统恢复到之前正常的状态。因其出色的备份与恢复能力，在Arch Linux堪称“必装软件”！
反而隔壁Timeshift，Rsync很慢，Btrfs有bug！不信请看VCR：\

真实案例1： 原作者曾在Ta的March7th Ace 41.2实体机备份系统后使用sudo dnf upgrade --refresh进行系统更新，结果Ta的AMD显卡驱动炸了！因为Ta在安装March7th Ace 41.2时使用了ext4文件系统，只能使用Timeshift Rsync。Ta尝试恢复备份，结果因为Ta的系统有一堆零碎文件，导致不管是备份还是恢复都很慢！
Moieo的调侃： “你当时就应该用Snapper！现在怎么办？凉拌！ ”（拿起Fedora 42 Live USB疯狂暗示原作者）
真实案例2： 原作者不信邪，使用Btrfs子卷模式重装March7th Vista 42.1后尝试立即使用Timeshift Btrfs备份，备份很快，但到了关键时候就掉链子了！Ta继续尝试更新系统，重启后还是一样：AMD显卡驱动炸了！于是，Ta尝试恢复之前的备份，结果！重启后，系统屡次Kernel Panic！于是，Ta就只好重装March7th Vista 42.3，并和Ta的数据说拜拜咯！
群友3595258138的回复： timeshift不适用于Btrfs，强行使用可能会导致还原出错系统崩溃，Btrfs可考虑使用opensuse的snapper

2. 如何使用Snapper？#

详见 Snapper - Arch Linux 中文维基。

❓ 六、Q&A#

Q：不添加archlinuxcn密钥会怎么样？
A：会收到“签名无效”警告，无法安装paru、中文输入法、微信等archlinuxcn源软件，然后只能重装系统💥

Q：sudo和doas我该用哪个？
A：优先使用sudo。如果你的sudo坏了（如“即使密码输入正确，也提示验证失败”），则使用doas。

Q：为什么在tty下输入其他命令前还需要执行LANG=C？
A：这可不是什么“仪式感”！因为tty无法显示中文！执行后，该终端执行的命令会以英文输出。（当然这不会影响桌面环境下的终端，因此你每次进tty都得执行一遍这个）

Q：为什么推荐使用paru进行所有软件包操作，而不是使用pacman和yay？
A：paru是一个新晋AUR助手。它有一个很NB的点，那就是：paru支持无缝对接pacman，这一点yay干不到！通过paru，你就能像使用pacman那样，一键搜索官方源和AUR软件！（前面甚至都不用加sudo/doas，少打5个字符！）
当然，你也可以为了方便，在安装完成后，这么干！
Terminal window
1
echo 'alias yay=paru' >> ~/.bashrc
2
echo 'alias pacman=paru' >> ~/.bashrc
3
sudo -i # 好人干到底！！！
4
echo 'alias yay=paru' >> ~/.bashrc
5
echo 'alias pacman=paru' >> ~/.bashrc
如果你用的zsh，那你就这么干！
Terminal window
1
echo 'alias yay=paru' >> ~/.zshrc
2
echo 'alias pacman=paru' >> ~/.zshrc
温馨提示：别他妈手欠把paru扬了，到时候你只能暂时unalias把paru用pacman弄回来！

Q：为啥我创建快照时提示「空间不足」？
A：检查一下/.snapshots目录！

Btrfs 快照会共享文件数据，但子卷本身需要预留空间

如果你往系统里塞了 100 个 G 的原神缓存，快照空间当然会爆啊！（ du -sh /var/cache/paru自己查！）

Q：Btrfs 快照真的比 Rsync 快 100 倍？
A：实测数据说话：

Rsync 备份 20GB 系统：23 分钟（零碎文件让它像蜗牛）

Btrfs 快照：0.3 秒（写时复制直接“克隆”元数据）
（这就是为什么我宁愿花 1 小时研究 Btrfs，也不愿再等 Rsync 龟速备份）

Q：不小心把重要快照扬了，还能抢救吗？
A：节哀顺变…

Btrfs快照删除后默认直接释放空间，不像Rsync有“保留版本”机制

下次记得定期检查快照列表（btrfs subvolume list /.snapshots），别他妈手滑点“删除”！

Q：能不能用 Snapper 备份 Windows 分区？
A：你在想屁吃！

Timeshift 只认 Btrfs

Windows 的 NTFS 分区？建议用winsync或者直接买移动硬盘拷贝！

Q：教程里说「Snapper 是 Arch 必装」，真的不是广告吗？
A：当然不是！

除非 openSUSE 给我打钱（但他们开源项目穷得连服务器都靠爱发电）

装不装随你，但等你误扬/usr又没快照时，别他妈来论坛哭唧唧！

Q：能不能在快照期间强制关机？
A：你想炸系统啊？！

Btrfs 快照创建时正在记录元数据，强制关机可能导致文件系统损坏

正确做法：等快照完成，或者先喝杯咖啡再关机～

Q：系统卡顿/风扇狂转怎么办？
A：先查这！

打开终端输入 htop → 找出占用资源的进程（可能是paru编译AUR包）

笔记本用户：安装并启用power-profiles-daemon优化电池管理：
Terminal window
1
paru -S power-profiles-daemon
2
sudo systemctl enable power-profiles-daemon.service
3
sudo systemctl start power-profiles-daemon.service
桌面环境：GNOME默认后台服务较多，可禁用不必要的扩展

Q：SSD寿命会被Btrfs淦爆吗？
A：想多了！

Btrfs自带TRIM支持（默认启用）

日常使用下，512GB SSD撑10年没问题（除非你拿它当硬盘录像机）

Q：Steam游戏卡顿/闪退？
A：兼容模式欢迎你！
Terminal window
1
# 安装Steam Play
2
paru -S steam-native-runtime proton-ge-custom
3
# 右键游戏 → 属性 → Steam Play → 勾选“启用非Steam游戏兼容层”

Q：如何优雅地截图？
A：按下Print Screen键，直接进入GNOME Screenshot！

Q：能Arch上安装Windows软件吗？
A：当然能！简单程序：用wine！（paru -S wine-staging）复杂软件：装虚拟机！（Virtualbox/VMware）

Q：误删/usr了怎么办？
A：凉拌炒鸡蛋，好吃又好看！
Terminal window
1
reboot && sudo pacman -S arch-install-scripts  # 重装吧，少年
开玩笑的。。。如果你之前有Snapper备份，还可以抢救一下（Snapper没备份过你就重装吧老弟）

Q：Arch能用来办公吗？
A：不仅能！还能摸鱼！

办公：LibreOffice

摸鱼：

原神，启动！

崩铁，启动！

Q：为什么我们选择Arch而不是Ubuntu？
A：因为我们追求：

滚动更新带来的新鲜感

自己配置系统的掌控感

向新手炫耀时的成就感😎
（Ubuntu：那我走？）
以及…

不被Snap限制的自由感！
（Ubuntu：Snap多好用啊）

Q：Arch难吗？
A：那必须的！但学会后：

装Windows系统像过家家

看其他Linux文档像读小学课本

从此告别“电脑小白”称号🏆

Q：其他问题？
A：Arch Linux 中文维基里面请

Q：中文Wiki没写？
A：出门右拐 Arch Linux Wiki

Q：英文Wiki也没写？
A：（拍桌）大侠且慢！此处藏着30万Arch玩家，再难的坑也能给你盘出花来：Arch Linux 中文论坛

Q：为什么这个教程天天在更新？
A：原作者要么就是为了语言表述更准确，要么就是因为你们的建议要更新教程，以及呼应Arch Linux滚动更新

Q：当前教程版本号？ A：北京时间 2025年8月3日 20:00<00>

ArchLinux Plasma 6 开启Samba服务（文件共享）

2025-04-24T14:05:48.000Z

在 Plasma 6 中的 Dolphin 使用文件共享

安装相关的插件#

Terminal window

1
pacman -Sy kdenetwork-filesharing

编辑 Samba 配置文件#

文件路径 /etc/samba/smb.conf

1
[global]
2
 usershare path = /var/lib/samba/usershares
3
 usershare max shares = 100
4
 # usershare allow guests = yes
5
 usershare owner only = no
6
 workgroup = WORKGROUP
7
 security = user
8
 passdb backend = smbpasswd
9
 name resolve order = lmhosts bcast host wins
10
 unix charset = UTF-8
11
 load printers = no
12
 printing = bsd
13
 printcap name = /dev/null
14
 disable spoolss = yes
15
 show add printer wizard = no
16
 server string = Samba Server
17
 log file = /var/log/samba/log.%m
18
 # Put a capping on the size of the log files (in Kb).
19
 max log size = 50
20
 dns proxy = no
21
#============================ Share Definitions ==============================
22
#
23
#[homes]
24
# 启用这个块会默认共享对应用户的home目录
25
#  comment = Home Directories
26
#  browsable = no
27
#  writable = yes

展开收起

配置用户组和文件夹#

Terminal window

1
mkdir /var/lib/samba/usershares
2
groupadd fileshare
3
usermod -a -G fileshare $(whoami)
4
chown root:fileshare /var/lib/samba/usershares
5
chmod 1771 /var/lib/samba/usershares

启动 Samba 服务#

Terminal window

1
systemctl restart smb nmb
2
systemctl enable smb nmb

将Linux用户添加到Samba数据库#

这一步可以为Samba用户设置独立的密码

Terminal window

1
smbpasswd -a $(whoami)

重启#

Terminal window

1
reboot

ArchLinux安装过程

2025-04-23T07:21:37.000Z

连接网络#

插入有线连接再启动ISO就行了，不深究使用ping t.cn 能通就行了

更新系统时钟#

Terminal window

1
timedatectl set-ntp true
2
# 将系统时间与网络时间进行同步
3
timedatectl status
4
# 检查服务状态

更换镜像#

要换镜像网上搜去，这里不提供！

分区#

使用fdisk工具进行分区操作我这里使用的是

分区	大小	设备	备注
/	500GiB	/dev/nvme0n1p7	根目录（系统装在这个分区里）
/boot	1Gib	/dev/nvme0n1p6	引导分区
/boot/efi		/dev/nvme0n1p1	与Windows共用

格式化#

将创建好的分区进行格式化，这里使用btrfs格式的根目录分区 btrfs 格式的分区可以使用 zstd 进行压缩，支持快照功能

Terminal window

1
mkfs.btrfs -f /dev/nvme0n1p7
2
mkfs.ext4 /dev/nvme0n1p6

挂载分区

Terminal window

1
# 挂载根目录分区 (我是不是应该创建子卷更好，毕竟我已经用btrfs了都)
2
mount -t btrfs -o compress=zstd:5 /dev/nvme0n1p7 /mnt
3
# 创建引导分区挂载需要的文件夹
4
mkdir /mnt/boot
5
# 挂载引导分区
6
mount -t ext4 /dev/nvme0n1p6 /mnt/boot

安装系统基础软件#

Terminal window

1
pacstrap /mnt base base-devel linux linux-firmware btrfs-progs networkmanager neovim sudo bash bash-completion grub efibootmgr os-prober

生成 fstab 文件#

fstab 用来定义磁盘分区。它是 Linux 系统中重要的文件之一。使用 genfstab 自动根据当前挂载情况生成并写入 fstab 文件

Terminal window

1
genfstab -U /mnt > /mnt/etc/fstab

复查一下 /mnt/etc/fstab 确保没有错误

Terminal window

1
cat /mnt/etc/fstab

切换到系统中#

Terminal window

1
arch_chroot /mnt

修改时区#

Terminal window

1
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

🍧 碎碎念不要找北京啦！这里没有北京，只有上海啦！🚀

硬件时间设置#

将系统时间同步到硬件时间

Terminal window

1
hwclock --systohc

修改语言#

Terminal window

1
vim /etc/locale.gen

将en_US.UTF-8和zh_CN.UTF-8解除注释，然后用以下命令生成

Terminal window

1
locale-gen

需要添加相关的字体

Terminal window

1
sudo pacman -S noto-fonts-cjk noto-fonts-emoji noto-fonts-extra

创建用户#

如果需要安装plasma6桌面或者 GNOME 桌面，必须创建一个普通用户

Terminal window

1
useradd -G wheel [用户名]

安装 Grub#

Terminal window

1
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="Arch Linux"

生成Grub配置文件#

Terminal window

1
grub-mkconfig -o /boot/grub/grub.cfg

安装 Plasma 6#

蓝牙相关的，如果没有蓝牙可以省略 kde-applications 包含了KDE全家桶，不需要可以不装

Terminal window

1
pacman -S plasma kde-applications sddm networkmanager bluez bluez-utils

需要启动相关的服务

Terminal window

1
systemctl enable sddm bluetooth NetworkManager

安装完成#

Terminal window

1
exit # 退出 arch_chroot
2
umount -R /mnt
3
reboot

优化和问题解决#

电源管理#

Terminal window

1
sudo pacman -S power-profiles-daemon
2
sudo systemctl start power-profiles-daemon.service
3
sudo systemctl enable power-profiles-daemon.service

解决回退的蜂鸣声#

编辑 /etc/modprobe.d/nobeep.conf

1
blacklist pcspkr

sddm中蓝牙自动连接#

蓝牙被软锁了，但是暂时没发现其他解决方法，这样解决也可以编辑 /etc/udev/rules.d/99-rfkill-unblock-bluetooth.rules

1
ACTION=="add", SUBSYSTEM=="bluetooth", KERNEL=="hci0", RUN+="/usr/bin/rfkill unblock bluetooth"

配置 AMD GPU#

我用的是 AMD Radeon 780M 的集承显卡修改 /etc/mkinitcpio.conf

1
MODULES=(amdgpu radeon)

再修改 /etc/default/grub 中的 GRUB_CMDLINE_LINUX_DEFAULT 加入 radeon.cik_support=0 amdgpu.cik_support=1

解决OpenOCD/串口在Linux中的权限问题

2025-02-02T10:53:12.000Z

问题说明：普通用户使用 OpenOCD 进行烧录时，无法访问USB设备，Arduino无法访问串口，每次使用 sudo 或者 pkexec 都需要输入密码，非常麻烦

解决方案#

把 OpenOCD 的 openocd/contrib/60-openocd.rules 复制到 /etc/udev/rules.d/ 文件夹中

串口的权限问题#

编辑文件 sudo vim /etc/udev/rules.d/70-ttyusb.rules 文件内容

1
KERNEL=="ttyUSB[0-9]*", MODE="666"

以上方案执行sudo udevadm control --reload后生效

Linux的GNOME中配置Minecraft游戏环境

2025-01-30T12:00:00.000Z

测试环境#

Linux: Fedora 41
GNOME 47 HMCL 启动器：https://hmcl.huangyuhui.net/download/
HMCL
安装相关环境：

Terminal window

1
sudo dnf install java-21-openjdk openjfx

注意：Fedora 自带的 java-21-openjdk-handless 无法启动 HMCL

需要在 Dash 栏显示软件名称的，需要编辑文件 ~/.local/share/applications/hmcl.desktop 内容：

1
[Desktop Entry]
2
Encoding=UTF-8
3
Name=HMCL
4
GenericName=Hello Minecraft! Launcher
5
Comment=A launcher to start Minecraft
6
Exec=java -Dprism.forceGPU=true -jar /home/moieo/Minecraft/HMCL-3.6.11.jar
7
Icon=/home/moieo/Minecraft/.icon@8x.png
8
StartupWMClass=org.jackhuang.hmcl.Launcher
9
Terminal=false
10
Type=Application
11
Categories=Application;Game;

ICON 和 JAR 路径根据自己的情况修改 ICON 可以解压 JAR 包获取如果使用了 Rounded Window Corners Reborn 圆角插件的，需要将插件排除包名org.jackhuang.hmcl.Launcher，否则会有一个透明边框在外围

字体使用文泉驿，界面正常显示

Terminal window

1
sudo dnf install wqy-bitmap-fonts -y
2
sudo dnf install wqy-unibit-fonts -y
3
sudo dnf install wqy-zenhei-fonts -y

ADC 采样 NTC 热敏电阻计算实际温度值

2024-07-31T14:15:20.000Z

通过 ADC 方式采样 NTC 热敏电阻 (10K) 得到 12 位采样数据（右对齐）

通过 Steinhart-Hart 方程计算并得到温度计算公式适用于 3.3v 基准电压，12 位宽的情况

转换公式如下

1
#define to_temperature(adc_value) (1.0 / (0.001129148 + 0.000234185 * \
2
        log((10000 * adc_value * (3.3 / 4095.0)) / (3.3 - adc_value * \
3
        (3.3 / 4095.0))) + 0.0000000876741 * pow(log((10000 * adc_value * \
4
        (3.3 / 4095.0)) / (3.3 - adc_value * (3.3 / 4095.0))), 3))) - 273.15

STM32F103 实现 4x4 矩阵键盘的扫描

2024-07-09T11:44:57.000Z

直接放一个实物图在这里

实物图

接线放在这里~

STM32F103C8T6	4x4
A0	C4
A1	C3
A2	C2
A3	C1
A4	R1
A5	R2
A6	R3
A7	R4

实现原理#

遍历矩阵的每一行，开始时将当前遍历的行设置为低电平，再扫描每一列并判断找出为低电平的列号，符合要求时记录行号和列号结束当前行时再将当前行设置为高电平

源代码#

MATRIX_KEY_Sx 的编号由行号和列号组成 matrix_key.h

1
#ifndef __MATRIX_KEY__
2
#define __MATRIX_KEY__
3

4
#include <stm32f10x.h>
5

6
#define ROW_PINS (GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7) // 定义行引脚为GPIOA的4、5、6、7
7
#define COL_PINS (GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3) // 定义列引脚为GPIOA的0、1、2、3
8

9
// 第1行
10
#define MATRIX_KEY_S1  0x18 // 0001 1000
11
#define MATRIX_KEY_S2  0x14 // 0001 0100
12
#define MATRIX_KEY_S3  0x12 // 0001 0010
13
#define MATRIX_KEY_S4  0x11 // 0001 0001
14
// 第2行
15
#define MATRIX_KEY_S5  0x28 // 0010 1000
16
#define MATRIX_KEY_S6  0x24 // 0010 0100
17
#define MATRIX_KEY_S7  0x22 // 0010 0010
18
#define MATRIX_KEY_S8  0x21 // 0010 0001
19
// 第3行
20
#define MATRIX_KEY_S9  0x48 // 0100 0100
21
#define MATRIX_KEY_S10 0x44 // 0100 0100
22
#define MATRIX_KEY_S11 0x42 // 0100 0010
23
#define MATRIX_KEY_S12 0x41 // 0100 0001
24
// 第4行
25
#define MATRIX_KEY_S13 0x88 // 1000 1000
26
#define MATRIX_KEY_S14 0x84 // 1000 0100
27
#define MATRIX_KEY_S15 0x82 // 1000 0010
28
#define MATRIX_KEY_S16 0x81 // 1000 0001
29

30
void Init_Matrix_Key(void);
31

32
void Scan_Matrix_Key(void (*Call_Back)(uint8_t));
33

34
#endif

展开收起

matrix_key.c

1
#include <stm32f10x.h>
2
#include <Delay.h>
3
#include <matrix_key.h>
4

5
void Init_Matrix_Key(void) {
6
  GPIO_InitTypeDef GPIO_InitStructure;
7

8
  RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // 使能GPIOA时钟
9

10
  // 设置行引脚为推挽输出
11
  GPIO_InitStructure.GPIO_Pin = ROW_PINS;
12
  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
13
  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
14
  GPIO_Init(GPIOA, &GPIO_InitStructure);
15

16
  // 设置列引脚为上拉输入
17
  GPIO_InitStructure.GPIO_Pin = COL_PINS;
18
  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;
19
  GPIO_Init(GPIOA, &GPIO_InitStructure);
20
}
21

22
void Scan_Matrix_Key(void (*Call_Back)(uint8_t)) {
23
  uint8_t row, col;
24
  uint8_t keyDetected = 0;
25

26
  for (row = 0; row < 4; row++) {                                  // 遍历行
27
    GPIO_ResetBits(GPIOA, 1 << (row + 4));                // 将当前行置为低电平，注意这里使用1 << (row + 4)来选中行
28
    Delay_us(10);                                                  // 短暂延时以稳定电平
29

30
    for (col = 0; col < 4; col++) {                                // 遍历列
31
      if (GPIO_ReadInputDataBit(GPIOA, 1 << col) == Bit_RESET) {   // 判断该列是否为低电平
32
        Delay_ms(100);                                             // 延时去抖动
33
        if (GPIO_ReadInputDataBit(GPIOA, 1 << col) == Bit_RESET) { // 再次检查，确认按键被按下
34
          keyDetected = (1 << col) | (1 << (row + 4));             // 记录按键位置
35
          Call_Back(keyDetected);
36
          break;                                                   // 跳出列循环，因为同一时间只能有一个按键被按下
37
        }
38
        while(GPIO_ReadInputDataBit(GPIOA, 1 << col) == Bit_RESET);// 等待弹起
39
      }
40
    }
41
    GPIO_SetBits(GPIOA, 1 << (row + 4));                           // 恢复该行至高电平
42
    if (keyDetected) {
43
      break;                                                       // 如果检测到按键，跳出行循环
44
    }
45
  }
46
}

展开收起

在 main 中调用

1
void Matrix_Key_Callback(uint8_t key) {
2
  switch(key) {
3
    case MATRIX_KEY_S1:
4
      // TODO
5
      break;
6
  }
7
}
8

9
int main(void) {
10
  Init_Matrix_Key(); // 初始化
11
  while (1) {
12
    Scan_Matrix_Key(Matrix_Key_Callback);
13
  }
14
}

你可以在串口中输出按键的号码~

除了 VuePress，还有哪些文档工具值得推荐？

2024-02-04T09:16:24.000Z

为什么要使用文档生成工具？#

使用文档工具可以快速生成文档的静态网站，节省非常多的时间，提高效率，一致性以易于维护和分发

文档生成工具可以帮助作者将内容按照逻辑结构组织起来，比如章节、子章节等，确保信息有序且易于查找

统一主题样式，保持整个文档一致的品牌风格和视觉效果

自动生成目录，方便读者快速导航

生成的静态页面对搜索引擎友好，加载速度也较快，可以提高网站的访问速度和用户体验

首先说说 VuePress 吧

VuePress#

VuePress 是一个基于 Vue 的静态网站生成器。它使用 Markdown 来编写文档，并使用 Vue 来渲染文档内容

优点#

高度可定制：基于 Vue.js，可以非常灵活地定制文档界面和功能
性能优异：利用 Vue 的单页应用特性，提供良好的页面加载性能和用户体验
SEO 友好：默认集成了 SEO 优化功能
Markdown 支持：良好的 Markdown 支持，易于编写文档

缺点#

学习曲线：对于不熟悉 Vue.js 的用户来说，可能需要一定的学习成本。
**复杂配置：**对于高级功能，配置可能相对复杂。

Docusaurus#

Docusaurus 是一个简洁且强大的静态站点生成器，适用于快速构建和维护项目文档、博客和技术宣传页面。由Meta（前身为Facebook）开源，它利用React技术栈，使得用户能够以Markdown格式轻松编写和组织内容。

优点#

易于配置：配置简单，易于上手。
Markdown 支持：支持 Markdown，编写文档方便。
主题丰富：提供多个美观的主题供选择。
社区支持：由 Facebook 支持，社区活跃。

缺点#

功能相对有限：相比于 VuePress，高级功能可能不足。
性能：相比于 VuePress，页面加载速度可能较慢。

MkDocs#

MkDocs 是一个轻量级的静态网站生成器，专为编写和发布项目文档而设计。它允许用户使用简单的 Markdown 语言来撰写文档，并通过 MkDocs 的构建命令将这些 Markdown 文件转换成结构化的、美观的 HTML 静态网页。

优点#

简单易用：安装和配置简单，适合初学者。
** Markdown 友好**：对 Markdown 的支持很好，编写文档轻松。
可定制性：可以通过自定义 CSS 和模板进行一定程度的定制。
插件系统：有一套可用的插件，可以扩展功能。

缺点#

自定义能力有限：相对于 VuePress，复杂的自定义可能难以实现。
插件生态较小：相比于 VuePress，插件数量和功能有限。

mdBook#

mdBook 是一个用 Rust 语言编写的开源命令行工具，用于从 Markdown 文件创建和管理在线书籍、文档集或教程。它提供了一个结构化的环境来组织和构建包含章节、副标题以及可选的自定义导航和样式表等内容的电子书或文档项目。

这个工具只适合做一本书或文档，不适合多个文档的集合。

看起来比较不错，如果你用它来编写 Rust 相关的文档，可以生成一个直接调用官方的接口，直接在网页中执行 Rust 代码片段。

优点#

性能优异：使用 Rust 编写，加载速度快，性能稳定。
Markdown 原生支持：编写文档简单直观，格式化自然。
简洁专注：设计简单，专注于Markdown文档生成，没有多余的复杂功能
多平台支持：支持多种操作系统，方便使用。

缺点#

功能相对有限：相比于其他工具，可能缺乏一些高级功能和交互性。
插件生态较小：插件数量和功能有限，可能无法满足所有需求。
社区支持：虽然社区活跃，但规模不如 VuePress 和 Docusaurus。

使用 Caddy 部署 Vue 等单页面Web应用

2023-01-25T08:19:21.000Z

安装 Caddy#

Caddy 是一个 Go 语言编写的开源 HTTP 服务器

Caddy 有下面这些开箱即用的特性:

全自动支持 HTTP/2 协议，无需任何配置。

Caddy 使用 Let’s Encrypt 让你的站点全自动变成 HTTPS，无需任何配置。

合理使用多核多核得益于 go 的特性

完全支持 IPv6 环境

Caddy 对 WebSockets 有很好的支持

自动把 Markdown 转成 HTML

Caddy 对 log 格式的定义很容易

易于部署得益于 go 的特性，caddy 只是一个小小的二进制文件，没有依赖，很好部署

得益于 Go 的跨平台特性，Caddy 很容易的支持了三大主流系统：Windows、 Linux、Mac 来自知乎 @shooter

Caddy 官网

下载 Caddy

本文配置均使用 Caddyfile 文件

基本配置#

HTTP + HTTPS

1
moieo.cn {
2
  root * /srv/http # 网站根目录
3
  file_serve # 启用文件系统
4
}

HTTP

1
http://moieo.cn {
2
  root * /srv/http # 网站根目录
3
  file_serve # 启用文件系统
4
}

反之只用 HTTPS

Vue 等单页面应用部署#

1
moieo.cn {
2
  root * /srv/http # 网站的根目录
3
  encode gzip zstd # 开启 gzip
4

5
  route {
6
    # 找不到文件时 使用 index.html
7
    # 解决 history 路由模式 404 的问题
8
    try_files {path} /index.html
9
    file_server # 开启文件系统
10
  }
11

12
  # 处理日志
13
  log {
14
    output file /data/moieo.cn.log # 保存文件
15
    format console # 日志格式
16
    level INFO # 日志级别
17
  }
18
}

展开收起

开启 Caddy#

Terminal window

1
./caddy start --config ./Caddyfile

文档#

Caddy 官方文档

Caddy 中文文档

中文文档访问速度快

Vite+Vue使用外部CDN引用element-plus全家桶

2022-08-05T15:08:38.000Z

参考：vue3+vite2增加element-plus的CDN链接打包构建

网上 Vite.js 的资料少，踩了不少坑在掘金中找到一篇资料，但还是避免不了遇到了一些奇奇怪怪的问题

我这边使用的 vite-plugin-cdn-import 插件

解决

编辑 vite.config.ts

1
import { Plugin as importToCDN } from "vite-plugin-cdn-import";

1
importToCDN({
2
  modules: [
3
    {
4
      name: "vue",
5
      var: "Vue",
6
      path: "//unpkg.com/vue@next",
7
    },
8
    {
9
      name: "vuex",
10
      var: "Vuex",
11
      path: "//unpkg.com/vuex@next",
12
    },
13
    {
14
      name: "vue-class-component",
15
      var: "VueClassComponent",
16
      path: "//unpkg.com/vue-class-component@next",
17
    },
18
    {
19
      name: "element-plus",
20
      var: "ElementPlus",
21
      path: "//unpkg.com/element-plus",
22
      css: "//unpkg.com/element-plus/dist/index.css",
23
    },
24
  ],
25
}),

展开收起

用原文中的方法会出现错误原因参考：使用了pinia或其他依赖于vue的库

报错

上面方式可解决

SQLMap进行SQL注入测试

2022-07-31T14:59:35.000Z

提示：仅供学习使用，严禁用于违法用途

介绍#

简介#

SQLMap 是一个开源的渗透测试工具，可以用来自动化检测，利用SQL注入漏洞，获取数据库的权限。它的检测引擎非常强大，针对不同类型的数据库有不同的方案和选项，获取数据库中存储的数据。

目前支持 MySQL、Oracle、PostgreSQL、Microsoft SQL Server、Microsoft Access 等数据库

输出级别#

0：只显示python错误以及严重的信息 1：同时显示基本信息和警告信息（默认） 2：同时显示debug信息 3：同时显示注入的payload 4：同时显示HTTP请求 5：同时显示HTTP响应头 6：同时显示HTTP响应页面

安装#

注：安装SQLMap需要Python环境 {% link https://sqlmap.org SQLMap官网 %}

克隆仓库

Terminal window

1
git clone --depth 1 https://github.com/sqlmapproject/sqlmap.git sqlmap
2
cd sqlmap
3
python sqlmap.py

你也可以将它配置到环境变量中，具体方法请上搜索引擎找

运行图

我这边配置了环境变量，所以可直接执行

使用#

1. 检查是否存在注入#

例如注入目标为：http://127.0.0.1:8080/?id=1 则命令如下

Terminal window

1
python sqlmap.py -u "http://127.0.0.1:8080/?id=1"

执行过程如下

执行过程

执行完毕后，可看到数据库类型，如果服务器后端使用的是PHP语言，会显示PHP的版本

执行完毕

如图所示，数据库类型为 MySQL PHP版本为 8.1.8

2. 查询当前用户下所有数据库#

用途：该命令在确定网站存在SQL注入漏洞时，用于查询当前用户下的数据库

Terminal window

1
python sqlmap.py -u "http://127.0.0.1:8080/?id=1" --dbs

所有数据库

运行结束后可看到一些数据库的名称，它们将以[*]开头 --dbs参数缩写成-D xxx，该参数为查询xxx数据库下的内容

3. 获取数据库中的表名#

用途：该命令在确定网站存在SQL注入漏洞时，可获取数据库下所有表的名称

-D 参数用来指定数据库，例如 -D moieo

Terminal window

1
python sqlmap.py -u http://127.0.0.1:8080/?id=1 -D moieo --tables

所有数据表

运行结束后可看到所有数据表的名称，继续注入可使用 -T 参数，该参数为 --tables的缩写，用于指定数据表继续注入获取数据

4. 获取数据表的字段名#

用途：在查询完表名后，指定数据库和数据表进行注入测试，获取该表下所有字段

Terminal window

1
python sqlmap.py -u http://127.0.0.1:8080/?id=1 -D moieo -T moieo_comments --columns

所有字段

运行结束后得到所有字段

5. 获取数据表内存储的数据#

用途：在获取并确定数据表内有字段时使用，可获得数据表内存储的数据

Terminal window

1
python sqlmap.py -u http://127.0.0.1:8080/?id=1 -D moieo -T moieo_comments --dump

表内的所有数据

可以看到，执行结束后可获得数据表内每个字段的数据

其他选项#

1. 获取数据库所有用户#

在有权管理所有用户的情况下 --users 选项可获得数据库所有用户名

2. 获取数据库用户的密码#

在有权管理所有用户的情况下 --passwords 选项可获得所有用户的密码，该选项获得到的数据是经过哈希算法加密的可以尝试使用 https://www.cmd5.com/ 硬解

3. 获取当前网站数据库的名称#

--current-db 选项，可获得当前网站数据库的名称

4. 获取当前网站数据库使用的用户名称#

--current-user 选项，用于获取当前用户名称

杂项#

--is-dba 用于判断用户是否管理员权限

--roles 列出数据库管理员角色

--referer，当--level的参数为3或以上，用于指定来源网站，欺骗目标网站，参数为URL

--sql-shell 运行自定义SQL语句

--os-cmd 或 --os-shell 执行任意操作系统命令

--file-write xxx.php --file-dest xxx.php 上传文件到数据库服务器，前者为源文件路径，后者为目标数据库服务器的文件路径

--file-read 从数据库服务器中读取文件，参数为数据库服务器中的文件路径

IP查询接口分享

2022-07-23T03:52:58.000Z

阿里云#

阿里云ipip.net提供的 IP 查询接口

接口地址：https://api.myip.la/cn?json 请求示例

Terminal window

1
curl https://api.myip.la/cn?json

响应结果

1
{
2
  "ip": "172.104.94.100",
3
  "location": {
4
    "country_code": "JP",
5
    "country_name": "日本",
6
    "province": "东京都",
7
    "city": "品川区",
8
    "latitude": "35.6130514",
9
    "longitude": "139.7344198"
10
  }
11
}

详细文档

Moieo Api IP 查询接口#

接口地址：GET https://api.moieo.net/ip/114.114.114.114 请求头

名称	注释
timestamp	时间戳(ms)

请求示例例如 IP 为：114.114.114.114

Terminal window

1
curl -XGET -H "timestamp: $(date +%s%3N)" https://api.moieo.net/ip/114.114.114.114

响应结果

1
{
2
  "code": 200,
3
  "msg": "success",
4
  "data": {
5
    "ip": "114.114.114.114",
6
    "ip_number": 1920103026,
7
    "location": "江苏省南京市",
8
    "net_service": "南京信风网络科技有限公司GreatbitDNS服务器"
9
  }
10
}

数据来源于纯真网络开源数据库

晴雨笔记

Anubis 配置安装指南：为你的网站加上 PoW 护盾

安装方式#

编写Anubus相关配置文件#

配置 Nginx，添加相关配置项#

启动服务#

相关链接#

Vibe Coding 实战：用 AI 从零写了一个短链接平台

初始 prompt#

后面陆续加的功能#

踩的坑#

一点感受#

Astro & Fuwari优化配置

Twikoo评论区 💬#

底部计时功能 ⏳#

Arch Linux UEFI 安装指南：Btrfs 子卷 + GNOME 桌面环境

🎒 准备开始#

需要准备的东西#

重要注意事项#

🖥️ 启动Live环境#

启动方式选择#

💾 一、磁盘分区与配置#

1. 使用cfdisk分区工具#

分区步骤详解#

分区表示例#

2. 格式化分区操作#

3. Btrfs子卷设置#

4. 创建挂载点结构（请在挂载@子卷后执行）#

5. 分情况挂载磁盘#

📦 二、安装基础系统#

1. 配置pacman#

2. 使用国内镜像加速#

3. 安装基本系统#

⚙️ 三、系统基础配置#

1. 生成fstab#

2. 进入新系统环境#

3. 本地化设置#

4. 网络相关配置#

5. 用户账户管理#

6. 配置sudo和doas#

7. 安装引导程序#

8. 完成安装，准备重启#

🖥️ 四、安装图形界面#

1. 登录新系统#

2. 配置pacman#

3. 使用国内镜像加速#

4. 安装GNOME桌面环境、中文输入法和常用软件#

5. 字体缓存重建#

6. 启用显示管理器并重启#

🎉 四、大功告成#

🔙 五、Snapper使用教程#

1. Snapper是什么？#

2. 如何使用Snapper？#

❓ 六、Q&A#

ArchLinux Plasma 6 开启Samba服务（文件共享）

安装相关的插件#

编辑 Samba 配置文件#

配置用户组和文件夹#

启动 Samba 服务#

将Linux用户添加到Samba数据库#

重启#

ArchLinux安装过程

连接网络#

更新系统时钟#

更换镜像#

分区#

格式化#

安装系统基础软件#

生成 fstab 文件#

切换到系统中#

修改时区#

硬件时间设置#

修改语言#

创建用户#

安装 Grub#

生成Grub配置文件#

安装 Plasma 6#

安装完成#

优化和问题解决#

电源管理#