DEV Community: AXUM中文博客

《Mastering Postgres》示例数据的导入

AXUM中文博客 — Fri, 19 Sep 2025 07:32:17 +0000

该教程的示例数据库并不能使用 pg_store 导入，网上找了很多资料，终于整合出来了正确的导入方法。（这个教程的作者也不说明一下他是什么工具导出的数据、需要如何导入。大无语 😑）

下载示例数据库：

wget https://assets.tryhardassets.com/mp_demo_data.gz

导入

gzip -dc mp_demo_data.gz | psql -U postgres mastering_pg_data

（如有需要）请将 postgres 改为你的数据库用户名
请将 mastering_pg_data 该为你实际的数据库名称，示例数据将导入到该数据中
如果使用的是 docker 部署的 PostgreSQL，请先使用 docker cp 命令将下载的 mp_demo_data.gz 拷贝到容器内

使用 Zhparser 插件实现 PostgreSQL 中文全文检索

AXUM中文博客 — Fri, 19 Sep 2025 02:08:43 +0000

Docker 容器

docker run \
        --name postgres \
        -e POSTGRES_PASSWORD=postgres \
        -e TZ=PRC \
        --restart=always \
        -e PGDATA=/var/lib/postgresql/data/pgdata \
        -v /var/docker/postgres:/var/lib/postgresql/data \
        -p 5432:5432 \
        -d postgres

docker exec -it postgres bash # 进入 pg 容器

编译安装 Zhparser

以下步骤都是在 PG 容器中操作。

安装依赖：

postgresql-server-dev-18 改成对应版本，也可以在 docker run 中明确指定拉取的镜像版本，以便保持统一。
如果不确定 docker 拉取的是那个版本的 postgres，可以在 psql 里运行 SELECT VERSION(); 查看

apt update -y && apt install wget gcc make git bzip2 postgresql-server-dev-18 -y

编译 Zhparser：

cd /tmp
wget http://www.xunsearch.com/scws/down/scws-1.2.3.tar.bz2
tar -jxvf scws-1.2.3.tar.bz2 
cd scws-1.2.3
./configure && make && make install

cd ..
git clone https://github.com/amutu/zhparser.git
cd zhparser/
make && make install

验证安装。首先连接到 PG 服务器：

psql -U postgres

然后：

CREATE EXTENSION zhparser; -- 启用 Zhparser 扩展
CREATE TEXT SEARCH CONFIGURATION chinese (PARSER = zhparser); -- 中文全文检索
ALTER TEXT SEARCH CONFIGURATION chinese ADD MAPPING FOR n,v,a,i,e,l WITH simple; -- 修改词性
select ts_token_type('zhparser'); -- 词性列表

测试：

to_tsvector 测试：

SELECT to_tsvector('chinese','人生得意须尽欢，莫使金樽空对月。天生我材必有用，千金散尽还复来。Hello world');

结果：

                                                         to_tsvector
------------------------------------------------------------------------------------------------------------------------------
 'hello':12 'world':13 '人生':1 '使':4 '千金':8 '复来':11 '天生我材必有用':7 '对月':6 '尽':10 '尽欢':3 '得意':2 '散':9 '空':5
(1 row)

to_tsquery 测试：

SELECT to_tsquery('chinese', '金风玉露一相逢，便胜却人间无数。It & works');

结果：

                          to_tsquery
--------------------------------------------------------------
 '金风玉露' <-> '相逢' <-> '胜' <-> '人间' <-> 'it' & 'works'
(1 row)

官方镜像

Zhparser 官方提供了 docker 镜像，但它使用的是 PostgreSQL 16，好在版本不算太低。偷懒的或者想要快速体验的朋友可以使用。

使用方法很简单，就是把 docker 镜像的名称换成 zhparser/zhparser:bookworm-16 即可：

docker run \
        --name postgres \
        -e POSTGRES_PASSWORD=postgres \
        -e TZ=PRC \
        --restart=always \
        -e PGDATA=/var/lib/postgresql/data/pgdata \
        -v /var/docker/postgres:/var/lib/postgresql/data \
        -p 5432:5432 \
        -d zhparser/zhparser:bookworm-16

参考：

使用自签证书在局域网部署 HTTPS 并让浏览器识别为『安全』

AXUM中文博客 — Fri, 03 Jan 2025 01:24:18 +0000

自签证书

我们将使用 openssl 来自签证书，请确保你已安装了该工具。

自签IP证书

openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout <私钥路径>.key -out ./<证书路径>.crt -subj '/CN=<组织名称>' -addext 'subjectAltName=IP:<局域网IP地址>'

<私钥路径>：要保存私钥的路径
<证书路径>：要保存证书的路径
<组织名称>：签发证书的组织的名称
<局域网IP地址>：本机IP地址

举例：

openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout ./oneplus.key -out ./oneplus.crt -subj '/CN=ONEPLUS' -addext 'subjectAltName=IP:192.168.1.13'

自签“域名”证书

和 IP 证书类似，自签“域名”证书的唯一不同的是 subjectAltName 要修改为 DNS:<域名>：

openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout <私钥路径>.key -out <证书路径>.crt -subj '/CN=<组织名称>' -addext 'subjectAltName=DNS:<域名>'

<域名>：绑定到该局域网的域名。通常，我们可以在客户机上修改 hosts 文件进行绑定。

举例：

openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout ./oneplus.key -out ./oneplus.crt -subj '/CN=ONEPLUS' -addext 'subjectAltName=DNS:oneplus.axum.rs'

修改 hosts

Linux/MacOS：/etc/hosts
Windows：C:\Windows\System32\drivers\etc

在文件末尾加上：

<IP地址> <域名>

举例：

192.168.1.13 oneplus.axum.rs

Windows 安装根证书

将上一步骤生成的 .crt 文件通过 SFTP 等软件，复制到 Windows 中。然后双击该文件，点击安装，然后选择受信任的根证书颁发机构即可

termux 中 proot-distro debian 的 root 用户的家目录位于： /data/data/com.termux/files/usr/var/lib/proot-distro/installed-rootfs/debian/root

Code Server 设置

修改 Code Server 配置文件：

// ...
cert: <证书路径>.crt
cert-key: <私钥路径>.key

举例：

// ...
cert: /root/.config/code-server/oneplus.crt
cert-key: /root/.config/code-server/oneplus.key

重启 Code Server。

让安卓手机不再吃灰：在安卓手机上搭建 Rust 开发环境

AXUM中文博客 — Fri, 03 Jan 2025 00:40:24 +0000

如果你还在把旧手机拿去换不锈钢脸盆，那真是暴殄天物。何不将它变成包括 Rust 在内的开发环境呢。

安装 termux

打开 termux 的官网，点击【DOWNLOADF-DROID】下载 APK 文件。
运行下载好的 APK 文件进行安装。

启用 SSH 服务

由于要兼容未进行 root 的手机，所以 termux 的 SSH 服务监听的是 8022 端口，而不是标准的 22 端口。（小端口监听需要 root 权限）。
同样的原因，termux 的用户名并不是 root，而是每次安装 termux 自动生成的、形如 u0_axxx（其中，xxx是数字）的用户。

安装 SSH

# 更新 termux 软件源
pkg update && \
# 安装 openssh 提供的 SSH 服务端和客户端
pkg install openssh

修改当前用户的密码

passwd

输入以上命令后，按提示设置密码

查看当前用户

whoami

将会显示形如 u0_axxx 的用户名，把它记录下来。

举例：u0_a117

查看当前IP

你可以通过手机的 WLAN 查看当前局域网 IP，也可以通过 ifconfig 命令来查看：

ifconfig | greap inte

举例：192.168.0.13

运行 SSH 服务

通过 sshd 命令启动运行 SSH 服务：

sshd

连接该 SSH 服务

现在，局域网内的其它设备，比如电脑等，可以通过 SSH 连接该手机了：

ssh -P 8022 u0_a117@192.168.0.13

将 u0_a117 改为你实际的用户名
将 192.168.0.13 改为你实际的IP

安装 debian

termux 自带的是一个非完整的 Linux 环境，好在我们可以在不需要对手机进行 root 的情况下，通过 proot-distro 安装完整的 Linux 环境，比如 debian 系统。

# 更新 termux 软件源
pkg update && \
# 安装 proot-distro
pkg install proot-distro && \
# 使用 proot-distro 安装 debian
proot-distro install debian

安装好之后，便可以登录 debian：

proot-distro login debian

proot-distro login 是以 root 身份登录 debian，所以享有完全的权限。首先要做的是给 debian 安装一些必要的工具：

# 更新软件源
apt update -y && \
# 更新软件包
apt upgrade -y && \
# 安装需要的工具
apt install -y wget curl unzip tmux build-essential cmake pkg-config libssl-dev libtool git

安装 Rust 环境

参照官网，我们可以在 debian 里一键安装 Rust 环境：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Code Server

安装

在 Code Server 的release页面，找到最新版本的压缩包下载。

# 版本
CODE_SERVER_VERSION='4.96.2'
# 下载
wget "https://github.com/coder/code-server/releases/download/v${CODE_SERVER_VERSION}/code-server-${CODE_SERVER_VERSION}-linux-arm64.tar.gz" && \
# 确保 ~/.local 存在
mkdir -p ~/.local && \
# 解压到 ~/.local
tar zxvf code-server-${CODE_SERVER_VERSION}-linux-arm64.tar.gz -C ~/.local
# 重命名
mv ~/.local/code-server-${CODE_SERVER_VERSION}-linux-arm64 ~/.local/code-server

注意：

必须选择 arm64 架构，因为手机 CPU 就是这个架构
本例使用的是 .tar.gz 压缩包，你也可以选择 .deb 等

运行

我们使用 tmux 来保证断开 SSH 之后 Code Server 依然在运行。首先创建 tmux 会话：

# 创建一个 tmux 会话
tmux new -s code-server

运行 Code Server：

~/.local/code-server/bin/code-server

修改配置

配置文件位于 ~/.config/code-server/config.yaml。根据你的需要进行更改

bind-addr：监听地址。为了让局域网能访问到，需要将监听的IP改为 0.0.0.0。比如：0.0.0.0:58080
auth：鉴权方式。由于我们是部署在局域网，给自己用的，完全没必要使用任何鉴权方式，所以将其改为 none
cert：证书路径。我们将在下一篇进行讲解。

修改配置之后，需要重新启动 Code Server。

启用 SSL

由于 Code Server 是以 Web 形式运行，而很多功能需要 HTTPS，比如复制/粘贴、预览 Markdown、执行 REST Client 等。我们将在下一篇博文讨论如何在局域网签发 SSL 证书。

自问自答

为什么不用 VSCODE 的远程 SSH 连接，而用 Code Server？

因为 termux 并不是完整的 Linux 环境，而 VSCODE 远程 SSH 连接需要在服务端安装对应的软件，termux 并不满足它的条件，所以只能退而求之，使用 VSCODE 的 Web 版本──Code Server。

你也可以尝试在 proot-distro 安装的 Linux 里安装 SSH 服务，它应该满足 VSCODE 的要求，但需要配置的地方可能很多，本文不作尝试。

相较于云服务器，使用手机有什么优势？

手机基本上都是 4G RAM 起步，内部存储更是 64G 起步，普通的 VPS 根本没法和它比。试想一下，购买一台相同配置的 VPS 每年需要花费多少钱？

另外，手机都是通过局域网连接，而包括 VPS 在内的云服务器都是公网连接，甚至是跨洲绕全球的连接，网络响应不是一个级别的。