红枫吟 - 技术

ubuntu24.04环境配置

Fri, 02 Jan 2026 18:51:48 +0000

最近我在腾讯云的服务器快过期了，但是续费又太贵，所以趁着活动又买了一台3年的轻量云。其实这台服务器上也没有什么服务，主要还是因为有一个已经备案的域名需要保一下，否则备案掉了之后再次备案太过麻烦。

我之前的服务器还在用着 ubuntu18.04 LTS，此次迁移准备升级一下系统到 ubuntu24.04 LTS，故此记录

注意: 以下命令以 # 开头则使用的是root账户，以 $ 开头则为普通账户

系统设置

修改主机名称

1# hostnamectl set-hostname [名称]

创建新用户

删除已存在的用户

1# deluser --remove-home ubuntu
2# deluser --remove-home lighthouse

添加新用户
```
1# adduser myuser
```
用户信息比如全名、房间号等，这些可以直接按 Enter 跳过
添加sudo权限
```
1# usermod -aG sudo myuser
```

添加公钥

1# su - 用户名
2$ mkdir ~/.ssh
3$ chmod 700 ~/.ssh
4$ vi ~/.ssh/authorized_keys
5$ chmod 600 ~/.ssh/authorized_keys

连接数限制

编辑文件 /etc/security/limits.conf，在文件末尾添加以下内容：

1* soft nofile 65535
2* hard nofile 65535
3* soft nproc 20480
4* hard nproc 20480

注：nofile 是文件打开数，nproc 是最大进程数。* 代表除 root 外的所有用户，如果需要添加 root，则增加

1root soft nofile 65535
2root hard nofile 65535

交换内存

默认的 vm.swappiness 为 60，表示内存使用率超过 100%-60%=40% 时就开始使用交换分区

查看当前swappiness
```
1$ cat /proc/sys/vm/swappiness
```

临时修改

1$ sudo sysctl vm.swappiness=10
2$ cat /proc/sys/vm/swappiness

永久修改

1$ echo "vm.swappiness=10" | sudo tee -a /etc/sysctl.conf
2$ sudo sysctl -p

启用BBR

1$ echo "net.core.default_qdisc=fq" | sudo tee -a /etc/sysctl.conf
2$ echo "net.ipv4.tcp_congestion_control=bbr" | sudo tee -a /etc/sysctl.conf
3$ sudo sysctl -p

系统服务

motd

禁用终端广告

1sudo sed -i 's/ENABLED=1/ENABLED=0/' /etc/default/motd-news

pro

禁用 pro 和 esm 的相关提示

1$ sudo chmod -x /etc/update-motd.d/10-help-text
2$ sudo chmod -x /etc/update-motd.d/91-contract-ua-esm-status
3$ sudo chmod -x /etc/update-motd.d/90-updates-available

只清空，不删除文件

1sudo truncate -s 0 /etc/apt/apt.conf.d/20apt-esm-hook.conf

ssh

修改配置 /etc/ssh/sshd_config

修改端口
```
1Port 22
```
取消注释并修改为想要的端口，然后在腾讯云控制台防火墙添加放行策略
禁用root登陆
```
1PermitRootLogin no
```
请在添加完成普通用户后再操作

重启服务

1$ sudo systemctl restart ssh

如果修改 sshd_config 不生效

1$ sudo systemctl stop ssh.socket
2$ sudo systemctl disable ssh.socket
3$ sudo systemctl restart ssh

unattended-upgrades

停止服务

1$ sudo systemctl stop unattended-upgrades
2$ sudo systemctl disable unattended-upgrades

卸载

1$ sudo apt remove --purge unattended-upgrades

snap

停止服务

1$ sudo systemctl stop snapd.service
2$ sudo systemctl disable snapd.service
3$ sudo systemctl mask snapd.service

查看已安装软件
```
1$ snap list
```
卸载安装软件(把使用 snap 安装的软件依次卸载)
```
1$ sudo snap remove --purge [软件名称]
```

卸载 snap

1$ sudo apt autoremove --purge snapd

清理目录

1$ sudo rm -rf /var/cache/snapd
2$ sudo rm -rf /var/snap
3$ sudo rm -rf /var/lib/snapd

阻止 snapd 被自动重新安装

1$ sudo cat <<EOF | sudo tee /etc/apt/preferences.d/nosnap.pref
2Package: snapd
3Pin: release a=*
4Pin-Priority: -10
5EOF

其它服务

docker

官方文档: https://docs.docker.com/engine/install/ubuntu/

设置apt仓库

 1$ sudo apt update
 2$ sudo apt install ca-certificates curl
 3$ sudo install -m 0755 -d /etc/apt/keyrings
 4$ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
 5$ sudo chmod a+r /etc/apt/keyrings/docker.asc
 6$ sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
 7Types: deb
 8URIs: https://download.docker.com/linux/ubuntu
 9Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
10Components: stable
11Signed-By: /etc/apt/keyrings/docker.asc
12EOF
13$ sudo apt update

安装

1$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

普通用户权限
```
1$ sudo usermod -aG docker [用户名]
```

镜像由于官方仓库无法连接，修改 /etc/docker/daemon.json 添加下面配置

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

然后重启docker即可

1$ sudo systemctl restart docker

other

1$ sudo apt install tree

腾讯云组件

卸载腾讯云内置的组件

1$ sudo /usr/local/qcloud/monitor/barad/admin/uninstall.sh
2$ sudo /usr/local/qcloud/stargate/admin/uninstall.sh
3$ sudo /usr/local/qcloud/YunJing/uninst.sh

让Eglot支持tailwindcss以及多个LSP服务

Fri, 02 Jan 2026 00:39:44 +0000

前言

虽然我不是专业的前端开发人员，但偶尔还是会写一下 HTML/CSS/Javascript 或者Vue。在一个 HTML 文件中，我需要使用多个 LSP服务，比如使用 vscode-html-language-server 补全css样式，使用tailwindcss-language-server 补全tailwindcss的class名称，使用 vscode-eslint-language-server 检查语法

但我目前使用的Emacs lSP客户端 Eglot 一直不支持多个LSP服务，目前的解决方式有两种，一是把 Eglot 更换为 lsp-mode 或者 lsp-bridge，二是使用第三方命令行代理服务，比如:

lspx 是因为我的电脑上没有相关环境，无法编译，rass 是由 Eglot 的作者开发，不过看情况他是准备把 rass 作为一个通用的LSP代理，所以配置文件会单独放置到 HOME 目录，这一点我不是很喜欢

算了，找来找去还不如自己写一个(轮子+1)，eglot-lspx，一个多LSP代理服务，用于解决 Eglot 无法使用 tailwindcss 以及不支持多个LSP服务的问题

如何使用？

编译

1git clone https://github.com/honmaple/eglot-lspx
2cd eglot-lspx
3go build .

然后把编译好的 eglot-lspx 文件放到可执行路径下，比如我放到了 ~/.emacs.d/bin 目录，并添加路径到Emacs配置

1(add-to-list 'exec-path (expand-file-name "bin" user-emacs-directory) t)

配置Eglot

 1(defvar eglot-lspx-command (executable-find "eglot-lspx"))
 2
 3(when eglot-lspx-command
 4  (add-to-list 'eglot-server-programs `((web-mode :language-id "html")
 5                                        . (,eglot-lspx-command
 6                                           "--" "vscode-html-language-server" "--stdio"
 7                                           "--" "tailwindcss-language-server" "--stdio")))
 8  (add-to-list 'eglot-server-programs `((vue-mode :language-id "html")
 9                                        . (,eglot-lspx-command
10                                           "--" "vue-language-server" "--stdio"
11                                           "--" "vscode-html-language-server" "--stdio"
12                                           "--" "tailwindcss-language-server" "--stdio"
13                                           :initializationOptions
14                                           (lambda (server) (list :vue-language-server (eglot-volar-options server)))))))

合并补全信息
```
1--provider completion=0,tailwindcss-language-server
```
可以使用LSP服务名或者索引名，使用逗号分隔，索引名即第n个LSP服务，从0开始，未设置将合并全部

示例

关于Android模拟器无法连接网络

Tue, 03 Jun 2025 13:55:08 +0000

一个很奇怪的问题，在模拟器测试安卓应用是总是显示

1Post "https://xxx": EOF

但偶尔又变得正常，通过一番查找，原来是设置 Android Studio 使用代理之后，通过其创建的模拟器也会默认使用代理。解决方式也很简单，只要打开模拟器设置然后取消代理即可

Flutter实现本地化多语言

Wed, 02 Oct 2024 13:12:27 +0000

内置组件本地化

添加依赖

Flutter默认组件的本地化只需要添加

1flutter_localizations:
2  sdk: flutter

使用命令行添加就是

1flutter pub add flutter_localizations --sdk=flutter

修改入口组件 main.dart

1import 'package:flutter_localizations/flutter_localizations.dart';

 1return const MaterialApp(
 2  title: 'Localizations Sample App',
 3  localizationsDelegates: [
 4    GlobalMaterialLocalizations.delegate,
 5    GlobalWidgetsLocalizations.delegate,
 6    GlobalCupertinoLocalizations.delegate,
 7  ],
 8  supportedLocales: [
 9    Locale('en'), // English
10    Locale('zh'), // Chinese
11  ],
12  home: MyHomePage(),
13);

这样Flutter内置组件所显示的语言就能和系统语言保持一致，如果想要手动修改，只需要添加参数

1return const MaterialApp(
2  ...
3  locale: Locale("zh"),
4);

如果想要修改指定的组件，需要使用到 Localizations.override

 1Widget build(BuildContext context) {
 2  return Scaffold(
 3    appBar: AppBar(
 4      title: Text(widget.title),
 5    ),
 6    body: Center(
 7      child: Column(
 8        mainAxisAlignment: MainAxisAlignment.center,
 9        children: <Widget>[
10          Localizations.override(
11            context: context,
12            locale: const Locale('zh'),
13            child: Builder(
14              builder: (context) {
15                return CalendarDatePicker(
16                  initialDate: DateTime.now(),
17                  firstDate: DateTime(1900),
18                  lastDate: DateTime(2100),
19                  onDateChanged: (value) {},
20                );
21              },
22            ),
23          ),
24        ],
25      ),
26    ),
27  );
28}

自定义本地化

根据官方文档，可以利用 flutter_localozations 和 intl 来实现。但是如果根据官方文档，那可不是一般的麻烦，而是相当麻烦，操作步骤包括但不限于

修改 pubsepc.yaml
添加 l10n.yaml
添加 .arb 文件

当然，这一切也不能说是很麻烦，毕竟只要第一次改好，后续只用修改 .arb 文件就能自动运行，但根据这个流程生成的多语言本地化，我觉得有几个问题：

自动生成的 .dart 文件是保存在 {项目目录}/.dart_tool/flutter_gen/gen_l10n 目录下的，这会导致项目默认的代码没有多语言相关，只有一些不知所谓的 .arb 文件，毕竟与多语言相关的代码都是自动生成的
也是最重要的一点，我为什么要在默认语言下重复定义一个不能带空格，只允许定义符合 dart方法名称 的关键字以供调用，比如一个简单的字符串
```
1Text("Hello World")
```
我必须在默认语言定义一个
```
1// app_es.arb
2"helloWorld": "Hello World"
```
然后在其它语言定义
```
1// app_zh.arb
2"helloWorld": "你好 世界"
```
最后再修改默认的调用
```
1Text(AppLocations.of(context).helloWorld)
```
我为什么不能直接使用原有的字符串呢，这样就不用再为默认的语言添加额外的翻译，比如
```
1Text(AppLocations.of(context).tr("Hello World"))
```

所以，我仔细研究了一下，大抵不用如此麻烦

自定义本地化(非代码自动生成)

首先添加 l10n.dart

 1import 'dart:async';
 2
 3import 'package:flutter/foundation.dart';
 4import 'package:flutter/widgets.dart';
 5import 'package:flutter_localizations/flutter_localizations.dart';
 6import 'package:intl/intl.dart' as intl;
 7
 8import 'l10n_en.dart';
 9import 'l10n_zh.dart';
10
11abstract class L10n {
12  L10n(String locale)
13  : localeName = intl.Intl.canonicalizedLocale(locale.toString());
14
15  final String localeName;
16
17  static L10n? of(BuildContext context) {
18    return Localizations.of<L10n>(context, L10n);
19  }
20
21  static const LocalizationsDelegate<L10n> delegate = _L10nDelegate();
22
23  static const List<LocalizationsDelegate<dynamic>> localizationsDelegates =
24  <LocalizationsDelegate<dynamic>>[
25    delegate,
26    GlobalMaterialLocalizations.delegate,
27    GlobalCupertinoLocalizations.delegate,
28    GlobalWidgetsLocalizations.delegate,
29  ];
30
31  static const List<Locale> supportedLocales = <Locale>[
32    Locale('en'),
33    Locale('zh')
34  ];
35
36  String tr(String key);
37}
38
39class _L10nDelegate extends LocalizationsDelegate<L10n> {
40  const _L10nDelegate();
41
42  @override
43  Future<L10n> load(Locale locale) {
44    return SynchronousFuture<L10n>(lookupL10n(locale));
45  }
46
47  @override
48  bool isSupported(Locale locale) =>
49  <String>['en', 'zh'].contains(locale.languageCode);
50
51  @override
52  bool shouldReload(_L10nDelegate old) => false;
53}
54
55L10n lookupL10n(Locale locale) {
56  // Lookup logic when only language code is specified.
57  switch (locale.languageCode) {
58    case 'en':
59    return L10nEn();
60    case 'zh':
61    return L10nZh();
62  }
63
64  throw FlutterError(
65    'L10n.delegate failed to load unsupported locale "$locale". This is likely '
66    'an issue with the localizations generation tool. Please file an issue '
67    'on GitHub with a reproducible sample app and the gen-l10n configuration '
68    'that was used.');
69}

上述代码其实是由根据官方文档自动生成的 .dart 文件转化而来

添加默认语言的翻译

 1// l10n_en.dart
 2import 'l10n.dart';
 3
 4class L10nEn extends L10n {
 5  L10nEn([String locale = 'en']) : super(locale);
 6
 7  @override
 8  String tr(String key) {
 9    return translations[key] ?? key;
10  }
11}
12
13const translations = {};

对的，你没有看错， translations 甚至可以是空的，这样就不用重复定义默认语言的翻译

添加其它语言的翻译

 1// l10n_zh.dart
 2import 'l10n.dart';
 3
 4class L10nZh extends L10n {
 5  L10nZh([String locale = 'zh']) : super(locale);
 6
 7  @override
 8  String tr(String key) {
 9    return translations[key] ?? key;
10  }
11}
12
13const translations = {
14  "Settings": "设置",
15  "Basic Settings": "基础设置",
16  "Theme": "主题",
17  "Language": "语言",
18  "About": "关于",
19  "Help": "帮助",
20};

修改 main.dart 入口组件

1import 'app/l10n/l10n.dart';
2
3return const MaterialApp(
4  title: 'Localizations Sample App',
5  localizationsDelegates: L10n.localizationsDelegates,
6  supportedLocales: L10n.supportedLocales,
7  home: MyHomePage(),
8);

这样就能使用自定义的翻译了

本地化多语言的使用

最常用的是在 Text 组件里

1Text(L10n.of(context)!.tr("Hello World"))

但是所有的字符都要添加 L10n.of(context)! 未免有些麻烦，所以我增加了自定义扩展

BuildContext

1extension L10nContext on BuildContext {
2  String tr(String key) {
3    final t = L10n.of(this);
4    if (t == null) {
5      return key;
6    }
7    return t.tr(key);
8  }
9}

使用方式

1Text(context.tr("Hello World"))

String

1extension L10nString on String {
2  String tr(BuildContext context) {
3    final t = L10n.of(context);
4    if (t == null) {
5      return this;
6    }
7    return t.tr(this);
8  }
9}

使用方式

1Text("Hello World".tr(context))

Text

 1extension L10nText on Text {
 2  Text tr(BuildContext context) {
 3    final t = L10n.of(context);
 4    if (t == null || data == null) {
 5      return this;
 6    }
 7    return Text(t.tr(data ?? ''),
 8      key: key,
 9      style: style,
10      strutStyle: strutStyle,
11      textAlign: textAlign,
12      textDirection: textDirection,
13      locale: locale,
14      softWrap: softWrap,
15      overflow: overflow,
16      textScaler: textScaler,
17      maxLines: maxLines,
18      semanticsLabel: semanticsLabel,
19      textWidthBasis: textWidthBasis);
20  }
21}

使用方式

1Text("Hello World").tr(context)

如此，就能最大限度的较少对原有代码的侵略性修改

优化多语言选择

我这里选用的是 riverpod 进行状态管理，首先定义一个本地语言的状态

1final localeProvider = StateProvider<String>((ref) {
2  return "zh";
3});

接着修改 main.dart

 1class MyApp extends ConsumerWidget {
 2  const MyApp({super.key});
 3
 4  @override
 5  Widget build(BuildContext context, WidgetRef ref) {
 6    final localeCode = ref.watch(localeProvider);
 7
 8    return MaterialApp(
 9      locale: L10n.delegate.isSupported(localeCode) ? Locale(localeCode) : null,
10      ...
11    );
12  }
13}

这样就能很方便地修改应用的显示语言

1ref.read(localeProvider.notifier).state = "zh";

参考文档

为maple-translate增加更友好的sdcv离线翻译

Mon, 22 Apr 2024 21:51:27 +0000

之前我写的Emacs翻译插件 maple-translate 有一个 sdcv 离线翻译的功能，它使用了 Elisp 解析 StarDict 的字典文件，所以不需要安装其它任何依赖。但是也是因为此原因，首次使用离线翻译需要等待字典文件加载到内存，这不是很友好，此次我将添加 sdcv 二进制文件的支持，使离线翻译能够更加快捷方便

首先是安装 sdcv 二进制文件

 1└──╼ brew install sdcv
 2└──╼ sdcv --help
 3用法：
 4  sdcv [选项…]  words
 5
 6帮助选项：
 7  -h, --help                     显示帮助选项
 8
 9应用程序选项：
10  -v, --version                  display version information and exit
11  -l, --list-dicts               display list of available dictionaries and exit
12  -u, --use-dict=bookname        for search use only dictionary with this bookname
13  -n, --non-interactive          for use in scripts
14  -j, --json-output              print the result formatted as JSON
15  --json                         print the result formatted as JSON
16  -e, --exact-search             do not fuzzy-search for similar words, only return exact matches
17  -0, --utf8-output              output must be in utf8
18  -1, --utf8-input               input of sdcv in utf8
19  -2, --data-dir=path/to/dir     use this directory as path to stardict data directory
20  -x, --only-data-dir            only use the dictionaries in data-dir, do not search in user and system directories
21  -c, --color                    colorize the output

然后定义二进制文件的路径，如果 sdcv 未安装，则返回为 nil

1(defvar maple-translate-sdcv-program (executable-find "sdcv"))

接着修改之前写好的 maple-translate-sdcv 函数，通过判断 maple-translate-sdcv-program 是否为空采取不同的翻译操作

 1(defun maple-translate-sdcv(word &optional callback)
 2  "Search WORD with sdcv, use async request if CALLBACK non-nil."
 3  (if maple-translate-sdcv-program
 4      (maple-translate-execute maple-translate-sdcv-program
 5        :args (append '("-n" "-x" "-j" "-0" "-1" "-2")
 6                      (cl-loop for dict in maple-translate-sdcv-dicts
 7                               collect (expand-file-name (cdr dict) maple-translate-sdcv-dir))
 8                      (list word))
 9        :format (maple-translate-sdcv-format)
10        :callback callback)
11    ;; ...
12    ;; 使用ELisp解析并翻译
13    ))

需要说明的是，由于该函数接收一个 callback 的变量，用于处理异步翻译，如果是同步翻译，可以直接使用 call-process 获取结果

1(with-temp-buffer
2  (apply 'call-process "sdcv" nil t nil '("-n" "-x" "-j" "-0" "-1" "-2" "/Users/xxx/.emacs.d/stardict/stardict-lazyworm-ec-2.4.2" "word"))
3  (buffer-string))

但如果是异步翻译，则需要使用 start-process ，再通过监听进程状态在进程结束后再获取翻译结果

1(let ((name (format "maple-translate-process %s" ,program)))
2  (set-process-sentinel
3   (apply 'start-process name (format "*%s*" name) ,program ,args)
4   (lambda(process _)
5     (unless (process-live-p process)
6       (with-current-buffer (process-buffer process)
7         (prog1 (funcall ,callback ,format)
8           (kill-buffer (current-buffer))))))))

这里的 buffer 名称也可以通过 (generate-new-buffer " *temp*" t) 生成一个临时 buffer

最后就是翻译结果的展示，由于输出的是多行 json，比如:

1[]
2[{"dict": "懒虫简明英汉词典","word":"word","definition":"\n[wә:d]\nn.\n字, 词, 话, 消息, 诺言, 命令\nvt.\n为...措辞"}]

所以我在解析翻译结果时取了个巧，没有使用 (buffer-string) 而是直接在 buffer 里操作，每次都跳到开始位置，再依次向下移动 n 行，这个 n 即是字典的数量，最后使用 (thing-at-point 'line t) 获取当前行的数据

 1(defun maple-translate-sdcv-format()
 2  "Format result with sdcv output."
 3  (let ((results (cl-loop for index from 0
 4                          for dicts in maple-translate-sdcv-dicts
 5                          collect
 6                          (progn
 7                            (goto-char (point-min))
 8                            (forward-line index)
 9                            (string-join (cl-loop for child across-ref (json-read-from-string (decode-coding-string (thing-at-point 'line t) 'utf-8))
10                                                  collect (format "%s: %s"
11                                                                  (alist-get 'dict child)
12                                                                  (alist-get 'definition child)))
13                                         "\n\n")))))
14    (unless (null results)
15      (string-join (cl-remove nil results) "\n\n"))))

最终效果

maple-translate的具体修改可见: dfd0eae

使用Homebrew Tap发布个人工具

Thu, 28 Mar 2024 09:31:23 +0000

作为MacOS用户，Homebrew 是必不可少的工具之一，正如它的描述所示 The missing package manager for macOS —— 它提供了很多 App Store 没有的软件和工具。

而什么是 Tap？Tap 全称 Third-Party Repositories，顾名思义为第三方仓库，它可以创建属于自己的软件集合，不用将软件发布到官方仓库，避免了和官方仓库的其它软件同名，也不用发PR，等审核等诸多优势。此次，我将创建一个 Homebrew Tap，用于为我自己开发的部分软件和工具提供更加方便的安装方式。

创建Tap

使用 brew 命令创建

 1└──╼ brew tap-new honmaple/tap
 2Initialized empty Git repository in /usr/local/Homebrew/Library/Taps/honmaple/homebrew-tap/.git/
 3[main (root-commit) 7d893ca] Create honmaple/tap tap
 4 3 files changed, 90 insertions(+)
 5 create mode 100644 .github/workflows/publish.yml
 6 create mode 100644 .github/workflows/tests.yml
 7 create mode 100644 README.md
 8==> Created honmaple/tap
 9/usr/local/Homebrew/Library/Taps/honmaple/homebrew-tap
10
11When a pull request making changes to a formula (or formulae) becomes green
12(all checks passed), then you can publish the built bottles.
13To do so, label your PR as `pr-pull` and the workflow will be triggered.

创建后会提示在 /usr/local/Homebrew/Library/Taps/honmaple/homebrew-tap/ 目录生成一个 Git 仓库

生成模版

比如我想要为已经打包好的工具 Snow 0.1.2 生成模版，注意指定 --tap 参数

1└──╼ brew create https://github.com/honmaple/snow/releases/download/v0.1.2/snow-darwin.tar.gz --tap honmaple/tap
2Formula name [snow]:
3...

在输入提示的工具名称后（也可以保持默认），这时会生成并使用默认编辑器打开 /usr/local/Homebrew/Library/Taps/honmaple/homebrew-tap/Formula/snow.rb，内容如下:

 1# Documentation: https://docs.brew.sh/Formula-Cookbook
 2#                https://rubydoc.brew.sh/Formula
 3# PLEASE REMOVE ALL GENERATED COMMENTS BEFORE SUBMITTING YOUR PULL REQUEST!
 4class Snow < Formula
 5  desc "static site generator"
 6  homepage ""
 7  url "https://github.com/honmaple/snow/releases/download/v0.1.2/snow-darwin.tar.gz"
 8  sha256 "78a65c740eff24193132e063654bd1d7023f6687c94ce852e50a03a43eaba558"
 9  license "BSD-3-Clause"
10
11  # depends_on "cmake" => :build
12
13  def install
14    # Remove unrecognized options if they cause configure to fail
15    # https://rubydoc.brew.sh/Formula.html#std_configure_args-instance_method
16    system "./configure", "--disable-silent-rules", *std_configure_args
17    # system "cmake", "-S", ".", "-B", "build", *std_cmake_args
18  end
19
20  test do
21    # `test do` will create, run in and delete a temporary directory.
22    # ...
23    system "false"
24  end
25end

修改模版

因为我此次发布的只是一个 Go 编译的二进制文件，只用将文件添加到可执行目录即可。如需其它操作，请查阅Homebrew Tap官方文档。

修改模版后内容如下：

 1class Snow < Formula
 2  homepage "https://github.com/honmaple/snow"
 3  desc "static site generator"
 4  url "https://github.com/honmaple/snow/releases/download/v0.1.2/snow-darwin.tar.gz"
 5  sha256 "78a65c740eff24193132e063654bd1d7023f6687c94ce852e50a03a43eaba558"
 6  license "BSD-3-Clause"
 7
 8  def install
 9    bin.install "snow"
10  end
11
12  test do
13    assert_match "snow version #{version}", shell_output("#{bin}/snow --version")
14  end
15end

从模版文件中就能看出，如果我们需要发布下一版本，只需要修改 url 和 sha256 两个参数，其中 sha256 可以使用 sha256sum v0.1.2/snow-darwin.tar.gz 获得

安装软件

1brew install honmaple/tap/snow

注意：不能直接使用 brew install snow，因为如果在 homebrew/core 有相同名称的包，默认将会安装 homebrew/core 上的包，所以必须指明使用哪个 Tap

上传到Github

首先需要到 Github 创建一个公共仓库，取名 homebrew-{Tap名称}, 比如我的是 honmaple/homebrew-tap，注意名称必须是 homebrew- 开头，方便后续直接使用 {用户名}/{Tap名称}。创建好后先不要克隆到本地

复制之前创建好的 honmaple/tap 目录，方便后续维护

1cp -r /usr/local/Homebrew/Library/Taps/honmaple/homebrew-tap ~/Git/

修改仓库

1cd ~/Git/homebrew-tap
2# 删除默认的Github Action
3rm -rf .github
4# 添加远程
5git remote add origin git@github.com:honmaple/homebrew-tap.git
6# 添加软件
7git add Formula/snow.rb
8git commit -m "add snow.rb"
9git push origin master

重置本地tap，首先需要卸载之前创建好的 honmaple/tap
```
1brew untap honmaple/tap
```
如果已经安装了 homebrew/tap/snow, 需要先卸载
```
1brew uninstall honmaple/tap/snow
```
在执行完 修改仓库 这一步后，就可以重新添加 tap
```
1brew tap honmaple/tap
```
并重新安装想要的软件
```
1brew install honample/tap/snow
```

结语

至此，创建一个私人使用的 MacOS 软件包集合就此结束，我可以往里面添加一些自己写的软件和工具，可以是 Bash 脚本，也可以是 Go 编译好的二进制等，后面就不用再指定具体目录或者手动复制文件到 $PATH/bin 目录下了。OK

使用Go重写MetingJS的API

Tue, 26 Dec 2023 13:23:00 +0000

MetingJS 是一款通过获取网易云音乐或者QQ音乐等服务的歌单、歌手、歌曲、歌词等信息，然后使用开源HTML5播放器 APlayer 进行播放的插件。而 MetingJS 是一段很小的JS代码，它提供了一个默认的API接口：https://api.i-meto.com/meting/api , 但很不幸，该接口偶尔会出问题，作者也很久没有回复issue了。

现在也有一个开源的 injahow/meting-api，该服务同样使用PHP编写，我不太懂PHP，我只是想要设置一个缓存，来缓存所有的歌曲信息，而不仅仅是歌单列表，另外是可以支持内存缓存和本地磁盘缓存，而不是直接从本地文件中读取。

基于此，与其自己改不是太懂的PHP，说不定会出现一些意想不到的漏洞(源自某安全公司多次CTF换来的教训)，不如使用熟悉的Go重写实现，毕竟核心代码也不是太多

功能

支持网易云音乐，QQ音乐
支持新服务接口扩展
支持所有请求结果的缓存
更方便的配置(环境变量+配置文件)，而不用修改源文件
基于 Go 编写，一次编译，到处运行

使用

手动部署

下载仓库

1git clone https://github.com/honmaple/meting-api

编译可执行文件
```
1go mod download
2go build -o meting-api .
```
或者使用 Docker 进行编译, 编译后的文件在 /usr/bin/meting-api
```
1docker build -t meting-api .
```
运行
```
1./meting-api -D
```

Docker部署

1docker run --name meting-api --restart=always -d -p 8000:8000 -v /tmp/meting-cache:/opt/meting-api/cache honmaple/meting-api

配置说明

配置可以使用环境变量或者配置文件设置

环境变量: 使用 METING_XXXX, 比如 METING_CACHE_TTL
配置文件: 默认使用当前目录下的 config.yaml, 如果使用 Docker 部署，需要文件挂载到 /opt/meting-api/config.yaml

具体配置:

 1# 缓存过期时间
 2cache.ttl:                  3600
 3# 缓存路径，设置为空是禁用缓存
 4cache.path:                 "./cache"
 5# 是否激活缓存
 6cache.enabled:              true
 7
 8# 服务监听地址，:8000 表示监听 0.0.0.0:8000
 9server.addr:                ":8000"
10# 对外服务地址，比如 https://api.xxxx.com/meting
11server.host:                ""
12
13## cors设置
14server.cors.allow_headers:
15  - "*"
16server.cors.allow_origins:
17  - "*"
18server.cors.allow_methods:
19  - "*"
20
21# 日志相关, out可选stdout,stderr,file，或者使用|分隔多个，比如stderr|file
22logger.out:                 "stdout"
23# 日志级别
24logger.level:               "info"
25# 日志文件名格式
26logger.file_format:         "%Y%m%d"
27# 日志文件保留数量
28logger.file_rotation_count: 3

命令行参数

查看支持的服务
```
1./meting-api --list
```

指定监听地址

1./meting-api -a :8001
2./meting-api --addr :8001

显示请求记录
```
1./meting-api -D
2./meting-api --debug
```

指定配置文件

1./meting-api -c /etc/meting.yaml
2./meting-api --config /etc/meting.yaml

显示当前配置
```
1./meting-api config
```

删除指定缓存

1./meting-api delete-cache 'server:netease:type:${type}:id:${id}'

网页端设置

其中 http://localhost:8000/ 是对外服务的接口

 1<meting-js
 2  server="netease"
 3  type="artist"
 4  id="6452">
 5</meting-js>
 6<script type="text/javascript">
 7  var meting_api='http://localhost:8000/?server=:server&type=:type&id=:id&auth=:auth&r=:r';
 8</script>
 9<script src="https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.js"></script>
10<script src="https://cdn.jsdelivr.net/npm/meting@2/dist/Meting.min.js"></script>

演示

重复造轮子之Emacs翻译插件maple-translate

Fri, 03 Nov 2023 22:19:03 +0000

我之前一直都在使用 youdao-dictionary 这个插件，虽然没有配置过秘钥，这时会有使用次数的限制(反正是每天1000次还是多少来着，有些忘了)，但是我平时使用次数不多，所以也不会达到使用限制，不管是单词翻译还是长句翻译都很不错。但最近几个月 youdao-dictionary 如果不配置私钥，处于一个完全不可用的状态。

我曾寻找过它的替代品，并且使用过一段时间的 fanyi.el，不可否认，这同样是一个非常不错的插件，不管是UI还是功能，但是，可能是因为 fanyi.el 使用异步请求的原因，偶尔会出现一些意想不到的报错，更重要的是它不支持长句翻译和离线翻译。

考虑再三，还是决定自己造一个轮子，主要功能就按照我之前使用 youdao-dictionary 的习惯:

翻译光标下的单词，以及选中的单词或句子

翻译的内容输出到 echoarea 或者新的 buffer，方便复制

增加一个离线翻译的功能，并且可以不依赖外部工具

基于上述，所以有了这个新的轮子 maple-translate

如何使用?

可以使用 quelpa 安装

1(use-package maple-translate
2  :quelpa (:fetcher github :repo "honmaple/emacs-maple-translate")
3  :commands (maple-translate maple-translate+))

或者手动下载仓库

1git clone https://github.com/honmaple/emacs-maple-translate ~/.emacs.d/site-lisp/maple-translate

然后进行配置

1(use-package maple-translate
2  :ensure nil
3  :commands (maple-translate maple-translate+))

长句翻译

~~目前长句翻译仅支持 youdao~~, 目前支持 youdao 和 google 两种翻译引擎，可以修改设置

1(setq maple-translate-engine 'youdao)
2;; 或者
3(setq maple-translate-engine 'google)

谷歌翻译

国内无法直接使用，但是可以单独为谷歌翻译设置代理

1(setq maple-translate-google-url "https://translate.googleapis.com/translate_a/single")
2(setq maple-translate-google-proxies
3      '(("http" . "127.0.0.1:1086")
4        ("https" . "127.0.0.1:1086")))

离线翻译

我个人平时在使用 Emacs 时不太习惯依赖外部的工具，比如我之前就写过一个markdown，org-mode实时预览插件 maple-preview，它区别于其它插件，并不会依赖外部的工具，比如 Pandoc，甚至不会生出任何文件到我的本地环境

同样的，我也不希望使用离线翻译时还要依赖外部诸如 sdcv，goldendict 等工具，我想要直接使用 Elisp 来对词典进行解析。所幸前人栽树，后人乘凉，已经有了一个纯 Elisp 实现的解析器 https://www.emacswiki.org/emacs/stardict.el

我所需要做的，就是下载需要的词典到本地(这个步骤是必须的，即使我不喜欢)，然后设置

1;; 离线词典所在的目录
2(setq maple-translate-sdcv-dir "~/.stardict/dicts")
3;; 所使用的词典 -> (词典名词 . 词典具体目录)
4(setq maple-translate-sdcv-dicts
5      '(("lazyworm-ec" . "stardict-lazyworm-ec-2.4.2")
6        ("lazyworm-ce" . "stardict-lazyworm-ce-2.4.2")))

最后修改翻译引擎

1(setq maple-translate-engine 'sdcv)

注意：第一次使用离线翻译需要等待词典初始化，这会需要耗费一段时间，后面就快了

多引擎翻译

maple-translate 同样支持多引擎，需要修改设置为一个列表

1(setq maple-translate-engine '(youdao dictcn sdcv))

翻译原理

目前支持的几个引擎: youdao(有道)、dictcn(海词)、iciba(金山词霸)、bing(必应)、google(谷歌)、sdcv(离线)。除 sdcv 外，其它几个都依赖于网络，maple-translate 可以看作是一个爬虫，通过爬取翻译页面，然后使用Emacs内置的 dom 对HTML进行解析，最后获取到想要的内容(谷歌使用API获取)。基于此，我还写了一个超简单的 类xpath 解析器

 1(defun maple-translate-dom-by-key(dom key)
 2  (let (func num)
 3    (when (string-match "\\[\\([0-9]+\\)\\]" key)
 4      (setq num (match-string 1 key))
 5      (setq key (substring key 0 (- (length key) (length num) 2))))
 6    (cond ((string-prefix-p "." key)
 7           (setq key (substring key 1) func 'dom-by-class))
 8          ((string-prefix-p "#" key)
 9           (setq key (substring key 1) func 'dom-by-id))
10          ((string-prefix-p "*" key)
11           (setq func (lambda(p _) (dom-children p))))
12          (t (setq key (intern key) func 'dom-by-tag)))
13    (if (null num)
14        (funcall func dom key)
15      (nth (string-to-number num) (funcall func dom key)))))
16
17(defun maple-translate-dom-find(dom xpath)
18  (cl-loop for key in (string-split (string-trim xpath) "/")
19           if (consp dom)
20           do (setq dom (maple-translate-dom-by-key dom key))
21           else return dom)
22  dom)

这样，我就能通过一些简单的语法来定位想要的内容，比如在有道里面使用

1(maple-translate-dom-find dom ".simple dict-module/.trans-container/.word-exp")

获取到 class 名称为 simple dict-module 下的 class 名称为 trans-container 下的 class 名称为 word-exp 的所有元素, 也就是基本释义

使用acme.sh申请SSL证书

Sun, 24 Sep 2023 13:57:51 +0000

部署教程

安装并配置acme.sh

安装
这里使用 Docker 安装，方便环境隔离。/opt/acme.sh 为挂载目录

1docker run -d --name acme.sh \
2-e AUTO_UPGRADE=0 \
3-e TZ=Asia/Shanghai \
4-v /opt/acme.sh:/acme.sh \
5neilpang/acme.sh daemon

配置
acme.sh 默认使用的是 ZeroSSL，我这里修改为 Let's Encrypt
```
1docker exec acme.sh --set-default-ca --server letsencrypt
2docker exec acme.sh --set-default-chain --preferred-chain "ISRG" --server letsencrypt
```
注：--preferred-chain "ISRG" 表示设置根证书为 ISRG Root X1, 它与 DST Root CA X3 的区别主要是
- ISRG Root X1 会更新一些，DST Root CA X3 已于2021年9月30日到期
- 一些旧的设备（例如，iPhone 4 或 HTC Dream）不会信任 ISRG Root X1，因为它们没有获得软件更新
- 虽说 DST Root CA X3 已到期，但Android设备仍能够继续正常访问使用 Let’s Encrypt 证书加密的网站，其它旧设备将会得到证书过期警告

注册账号(记得修改为自己的邮箱)

1docker exec acme.sh --register-account --server letsencrypt -m i@example.com
2[Sun Sep 24 15:49:59 CST 2023] Create account key ok.
3[Sun Sep 24 15:49:59 CST 2023] Registering account: https://acme-v02.api.letsencrypt.org/directory
4[Sun Sep 24 15:50:05 CST 2023] Registered
5[Sun Sep 24 15:50:05 CST 2023] ACCOUNT_THUMBPRINT='xxx'

这时会在 /acme.sh 目录下生成一个 http.header 文件，申请证书时会使用该文件

固定域名(webroot)

如果只有少数几个固定的域名，这时可以使用 webroot 方式申请SSL证书。webroot 方式会在本地生成一个验证文件，申请证书时通过验证该文件验证域名所有权

申请证书

1docker exec acme.sh --issue -d example.com -d www.example.com,nas.example.com -w /acme.sh/example.com

执行后会在挂载目录 /opt/acme.sh 下生成SSL证书相关的 cert 文件和 key 文件

1$ ls example.com
2ca.cer  fullchain.cer  example.com.cer  example.com.conf  example.com.csr  example.com.csr.conf  example.com.key

配置SSL证书

 1ssl_certificate /opt/acme.sh/example.com/fullchain.cer;
 2ssl_certificate_key /opt/acme.sh/example.com/example.com.key;
 3ssl_dhparam /opt/acme.sh/example.com/dhparam.pem;
 4
 5ssl_session_cache shared:SSL:1m;
 6ssl_session_timeout 5m;
 7
 8ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
 9ssl_ciphers EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
10ssl_prefer_server_ciphers on;

如何生成 dhparam 的证书?

1openssl dhparam -out /opt/acme.sh/example.com/dhparam.pem 2048

配置NGINX

Let's Encrypt 只会在 80 端口验证域名所有权，所以只需要在 80 端口添加一个 location

 1server {
 2    listen       80;
 3    listen  [::]:80;
 4    server_name  www.example.com nas.example.com;
 5
 6    location / {
 7        return 301 https://example.com$request_uri;
 8    }
 9    location ^~ /.well-known/acme-challenge {
10        alias /opt/acme.sh/example.com/.well-known/acme-challenge;
11    }
12}
13
14server {
15    listen       443 ssl;
16    listen       [::]:443 ssl;
17    server_name  nas.example.com;
18    include      /etc/nginx/conf.d/ssl/example.com.conf;
19
20    ......
21}

重启NGINX

1nginx -t
2nginx -s reload

泛域名(DNS)

webroot 无法申请泛域名证书，泛域名证书的申请需要利用DNS服务提供商的API，动态添加一个TEXT记录，这里以 Cloudflare 为例

令牌获取

右上角点击我的个人资料, 然后点击创建令牌

然后选择DNS模版

令牌名称可以随意
权限设置为 区域 -> DNS -> 编辑
区域资源设置为 包括 -> 特定区域 -> 域名(example.com)

继续以显示摘要, 然后创建令牌

最后记得保存令牌到本地

账户ID获取

选择对应的域名，在概况的右下角会有账户ID显示

编辑配置

编辑 /opt/acme.sh 目录下的 account.conf

1+ CF_Token='xxx'
2+ CF_Account_ID='xxx'

申请证书

1docker exec acme.sh --issue --dns dns_cf -d "nas.example.com" -d "*.nas.example.com"

安装证书

如果想要修改默认安装的目录，则可以使用 --install-cert 命令

1docker exec acme.sh --install-cert -d nas.example.com \
2--key-file /nginx/data/custom_ssl/npm-1/privkey.pem \
3--fullchain-file /nginx/data/custom_ssl/npm-1/fullchain.pem

如果想要更新证书后同步重启NGINX，可以继续添加命令参数

1--reloadcmd "nginx -s reload"

搭配NginxProxyManager

首先打开 NginxProxyManager, 选择 SSL Cetificates

然后选择 Add SSL Cetificates -> Custom

最后添加相关文件:

Certificate: nas.example.com.cer
Certificate Key: nas.example.com.key
Intermediate Certificate: ca.cer

为了避免证书过期后重新添加，需要把NginxProxyManager挂载目录也挂载到 acme.sh 容器

1docker stop acme.sh
2docker rm acme.sh
3docker run -d --name acme.sh \
4-e AUTO_UPGRADE=0 \
5-e TZ=Asia/Shanghai \
6-v /opt/acme.sh:/acme.sh \
7-v /opt/nginx:/nginx \
8neilpang/acme.sh daemon

然后修改申请证书的命令

1docker exec acme.sh --issue --dns dns_cf -d "nas.example.com" -d "*.nas.example.com" \
2--renew-hook "acme.sh --install-cert -d nas.example.com \
3--key-file /nginx/data/custom_ssl/npm-1/privkey.pem \
4--fullchain-file /nginx/data/custom_ssl/npm-1/fullchain.pem"

如果提示 Domains not changed, 则需要使用 --force 重新申请

更新证书(手动)

从 Let's Encrypt 申请到的证书有效期是90天，acme.sh 每60天会对证书进行更新，你也可以手动强制更新：

1# 查询证书申请信息
2acme.sh --list
3
4# 手动强制更新证书
5acme.sh --renew -d nas.example.com -d *.nas.example.com --force

参考资料

Zerotier笔记

Sun, 17 Sep 2023 15:41:40 +0000

zerotier 可谓是慕名许久，但之前一直没有太多内网穿透和异地组网的需求，此次准备在外网访问家里NAS部署的部分应用，所以也调研了一些相关的应用，最终选择了 zerotier 来对我现有的机器进行组网

FRP: 需要将服务器的端口映射出去，不太喜欢这种暴力的方式。我目前的服务基本上只会在 0.0.0.0 监听80、443等常用端口，其它服务一律监听 127.0.0.1，通过nginx访问内部的服务

DDNS: 家里的NAS直接暴露在公网，这非常不安全，而且家用宽带无法使用80，443端口，只能使用高位端口

ZEROTIER: 使用 P2P 的方式对多台服务器进行组网，映射的端口只允许加入组网的设备访问，这在速度和安全性上确实是我所需要的

部署教程

现在我有三台设备需要进行组网，一台A在国外，一台B在国内(腾讯云)，还有一台C在家里(NAS)。我准备将私有Planet部署到机器A，同时机器A也会加入到内网里，A、B、C三台设备可以通过内网相互访问

UI界面

以 jonnyan404/zerotier-planet 为例

创建目录
```
1mkdir /opt/zerotier /opt/ztncui
```

部署服务

1docker run -d --name ztncui --restart always \
2-p 4000:4000 -p 9993:9993/tcp -p 9993:9993/udp \
3-e MYADDR={服务器公网IP} \
4-e HTTP_PORT=4000 \
5-e HTTP_ALL_INTERFACES=yes \
6-e ZTNCUI_PASSWD=mrdoc.fun \
7-v /opt/zerotier:/var/lib/zerotier-one \
8-v /opt/ztncui:/opt/key-networks/ztncui/etc \
9keynetworks/ztncui

然后就可以通过 服务器公网IP:4000 访问UI管理界面，默认的用户名和密码: admin,mrdoc.fun

Zerotier客户端

Linux: 部署方式很简单，注意区分 host网络 和 bridge网络，这两个在安全性有所区别(具体在下面讲)

1docker run --name zerotier -d \
2--restart always \
3--net host \
4--cap-add NET_ADMIN \
5--device /dev/net/tun \
6-v /opt/zerotier:/var/lib/zerotier-one \
7zerotier/zerotier:latest

如果使用私有Planet，记得替换 /opt/zerotier/planet 文件

Android: 推荐使用 https://github.com/kaaass/ZerotierFix

私有Planet

默认的Planet信息是硬编码在zertier代码里，如果安装好客户端后会在 zerotier-cli peers 看到官方的Planet服务器。

而部署私有的Planet的目的:

官方的服务器基本都位于国外或者香港，服务连通性无法得到保证
安全性。试想一个陌生的设备加入到网络，而这个设备的许可只需要得到官方的认证即可。当然，官方是基本不可能发生这样的情况，但如果有一个完全控制的网络，何乐而不为呢

如何生成私有Planet文件?

1git clone https://github.com/jonnyan404/zerotier-planet --depth=1
2cd zerotier-planet
3docker cp mkmoonworld-x86_64 ztncui:/tmp
4docker cp patch.sh ztncui:/tmp
5docker exec -it ztncui bash /tmp/patch.sh
6docker restart ztncui

这样就会在挂载目录 /opt/zerotier 下生成一个新的 planet 文件，记得下载并备份。所有加入组网的客户端都需要替换该文件

私有Planet服务器加入组网

如果按照上述部署流程也可以正常使用 zerotier 组网，但是，如果想要把部署了私有Planet的设备也加入到内网，貌似没有一篇文章说到。所以我专门研究了一下，想要把私有Planet的机器也加入到内网，大概是可以分为下面几种方式:

(不推荐) 修改ztncui内部zerotier的默认端口9993
在 /opt/zerotier 目录下添加一个 local.conf，并设置
```
1{
2    "settings": {
3        "primaryPort": 9995
4    }
5}
```
然后修改 patch.sh 文件里的 9993 端口，以及 /start_ztncui.sh 添加一行
```
1echo "ZT_ADDR=localhost:$ZT_PORT" > /opt/key-networks/ztncui/.env
```
部署两个zerotier: 除了ztncui容器内部的一个zerotier，再在机器上部署一个客户端，并修改端口，避免端口冲突
(推荐) ztncui镜像的UI和zerotier分开部署
我研究后才发现 ztncui 的相关镜像把事情弄的很复杂，都把 ztncui 和 zerotier 放到同一个镜像，专门去连接 localhost:9993 。其实是可以把两个镜像分开的，UI 只做 UI ，使用 API 去连接 zerotier 官方的镜像

UI和Zerotier分开部署

如果想要自己构建Docker镜像，可以参考 honmaple/ztncui-aio

部署 zerotier 的客户端(部署过的可以忽略)

1docker run -d --name zerotier --restart always --net=host --cap-add NET_ADMIN --device /dev/net/tun -v /opt/zerotier:/var/lib/zerotier-one zerotier/zerotier:latest

部署 UI

 1docker run -d --name ztncui --restart always \
 2-e MYADDR={服务器IP} \
 3-e HTTP_PORT=4000 \
 4-e HTTP_ALL_INTERFACES=yes \
 5-e ZT_ADDR={zerotier地址, 比如Docker网关:9993} \
 6-e ZT_TOKEN={可以为空，但需要挂载zerotier-one的配置路径} \
 7-v /opt/ztncui:/opt/ztncui/etc \
 8-v /opt/zerotier:/var/lib/zerotier-one \
 9-p 4000:4000 \
10honmaple/ztncui:latest

ZT_ADDR: 由于 zerotier 和 ztncui 没有部署在一个容器，所以需要从UI内部访问宿主机的 9993 端口，这里可以使用UI容器的网关访问，比如UI容器的IP是 172.17.0.12，则访问 172.17.0.1

另外，zerotier 默认的API接口只允许 127.0.0.1 访问，所以需要在挂载目录 /opt/zerotier 下新建一个 local.conf

1{
2    "settings": {
3        "allowManagementFrom": ["127.0.0.1/24", "::1", "172.17.0.1/24"]
4    }
5}

修改归属的用户和用户组

1docker exec -it zerotier bash
2cd /var/lib/zerotier-one
3chown zerotier-one:zerotier-one local.conf
4exit

生成私有Planet文件

1git clone https://github.com/honmaple/ztncui-aio --depth=1
2cd ztncui-aio
3docker cp script/mkmoonworld-x86_64 zerotier:/tmp
4docker cp script/patch.sh zerotier:/tmp
5docker exec -it zerotier bash /tmp/patch.sh {服务器IP}

重启
```
1docker restart zerotier
```
这样就能使私有Planet和zerotier客户端共存，让Planet服务器也能加入到内网环境了

组网教程

创建网络

使用浏览器打开UI管理界面 {服务器公网IP}:4000，honmaple/ztncui 默认用户名密码是 admin,password
点击 Add network，输入一个网络名称，比如 testlab。然后选择 Easy setup
添加一个内网网段，记得这个内网网段不能和需要加入组网的设备网段相同，比如我的设备C网段是 192.168.31.0/24 ，就不能添加该网段，另外Docker所使用的网段 172.0.0.0/8 也需要避免添加，所以我这里选择 10.8.230.0/24。不同的设备内网网段不同，请根据实际添加

加入网络

创建好网络后就会得到一串网络ID，登录到设备，然后使用

1docker exec zerotier zerotier-cli join {网络ID}

加入网络，正常情况下会得到

1200 join OK

刷新管理界面就会出现一个新的成员然后勾选 Authorizerd 允许加入，再次刷新，就能看到该设备分配了一个新的IP 10.8.230.170

返回设备，可以看到设备多了一个新的IP

跨网段访问

什么是跨网段访问? 比如现在我可以通过 10.8.230.0/24 访问已经加入组网的设备，但我想要在设备B上访问我家里的其它设备，但是，我家里设备的网段是 192.168.31.0/24，正常是无法访问的，只能访问已经加入组网的Nas。这时需要配置静态路由，让设备B访问 192.168.31.0/24 网段时走zerotier配置好的IP。

如果手动添加就是

1ip route add 192.168.31.0/24 via 10.8.230.170 dev {zerotier建立的网卡}

当然，也可以直接使用zerotier管理界面添加，选择 Routes

Target 输入想要访问的网段：192.168.31.0/24，Gateway 输入之前分配的IP：10.8.230.170。

创建好后可以在设备B上执行

1ping 192.168.31.XX(除设备C之外的内网设备IP)

查看网络是否连通

安全限制

正因为跨网段访问只需要添加一个静态路由，就能访问我家里的其它设备，这无疑是非常不安全的。如果私有Planet服务器遭到入侵，我家里的所有联网设备都会暴露出去，即使加入组网只是其中的一台。基于此原因，我专门调整了一下zerotier的部署方式，不再使用 host网络 的方式部署，而是创建一个新的Docker网络 zerotier

1docker network create --driver=bridge --subnet=192.168.100.0/24 --gateway=192.168.100.1 zerotier

注: 192.168.100.0/24 是一个全新的网段，不要使用172网段

然后删除之前部署的 zerotier 客户端，并使用 zerotier网络 重新部署

1docker stop zerotier
2docker rm zerotier
3docker run -d --name zerotier --restart always --net zerotier --cap-add NET_ADMIN --device /dev/net/tun -v /opt/zerotier:/var/lib/zerotier-one zerotier/zerotier:latest

细心的朋友应该会发现我这里没有将 9993 端口映射给宿主机，这是由于我测试发现两台设备只需要其中一台开放 9993 端口，两台设备之间就能直连。如果两台设备都不开放端口，则会通过开放了端口的其它设备进行跳转，查看 peers 会看到一直是 RELAY 状态

1root@cf5f973bd294:/# zerotier-cli peers
2200 peers
3<ztaddr>   <ver>  <role> <lat> <link>   <lastTX> <lastRX> <path>
4xxxxxxxxx  1.12.1 LEAF      -1 RELAY

这时想要从设备B访问我家里其它联网的设备已是不可能，除非突破Docker的限制。而正常情况下，我想要从设备B上访问的是部署在设备C的其它服务(以Docker服务为主)，所以，现在可以添加一个新的路由 192.168.100.0/24 指向 10.8.230.170，然后修改其它镜像使用的网络为 zerotier

1docker run -d --rm --name=test-nginx --net=zerotier nginx:stable-alpine
2docker exec -it test-nginx ip a

接着在设备B上执行

1ping 192.168.100.3(test-nginx的IP)
2curl 192.168.100.3

如果无法访问，需要在Docker所在宿主机上添加路由

1ip route add 10.8.230.0/24 via 192.168.100.2(zerotier客户端的IP)

另外，由于Docker的IP可能会发生改变，除创建容器时指定 --ip 外，还可以将服务的端口映射出去，比如 NasTools 使用端口为 3000，那么可以在创建容器时指定

1-p 11300:3000

然后在设备B上访问 192.168.100.1:11300，即网关地址+映射的端口，这样就能避免Docker重启后IP发生改变而导致服务异常的情况

FAQ

如何修改默认的9993端口?

在 zerotier 挂载的目录下新建一个 local.conf 文件，并设置

1{
2    "settings": {
3        "primaryPort": 9995
4    }
5}

红枫吟 - 技术

ubuntu24.04环境配置

系统设置

修改主机名称

创建新用户

连接数限制

交换内存

启用BBR

系统服务

motd

pro

ssh

unattended-upgrades

snap

其它服务

docker

other

腾讯云组件

让Eglot支持tailwindcss以及多个LSP服务

前言

如何使用？

示例

关于Android模拟器无法连接网络

Flutter实现本地化多语言

内置组件本地化

自定义本地化

自定义本地化(非代码自动生成)

本地化多语言的使用

优化多语言选择

参考文档

为maple-translate增加更友好的sdcv离线翻译

使用Homebrew Tap发布个人工具

创建Tap

生成模版

修改模版

安装软件

上传到Github

结语

使用Go重写MetingJS的API

功能

使用

手动部署

Docker部署

配置说明

命令行参数

网页端设置

演示

重复造轮子之Emacs翻译插件maple-translate

如何使用?

长句翻译

谷歌翻译

离线翻译

多引擎翻译

翻译原理

使用acme.sh申请SSL证书

部署教程

安装并配置acme.sh

固定域名(webroot)

申请证书

配置SSL证书

配置NGINX

重启NGINX

泛域名(DNS)

令牌获取

账户ID获取

编辑配置

申请证书

安装证书

搭配NginxProxyManager

更新证书(手动)

参考资料

Zerotier笔记

相关概念

部署教程

UI界面

Zerotier客户端

私有Planet

私有Planet服务器加入组网

UI和Zerotier分开部署

组网教程