---
title: 开发指南
icon: signs-post
order: 7
---

::: info 提示

本项目处于早期开发阶段 (Early WIP)，如有 bug 请多担待。

:::

本项目使用了 `JavaScript` 和 `TypeScript` 实现。

如果你想参与 VanBlog 开发，可以进群哦：

- [VanBlog 开发群](https://jq.qq.com/?_wv=1027&k=mf2CguM8)



## 准备知识

### 整体架构

Vanblog 分为以下几个部分，构建后将整合到一个 `docker` 容器内：

> website: Vanblog 默认的主题，使用了 `nextjs` 框架，有运行时。
>
> server: Vanblog 的后端服务，有运行时。
>
> waline: Vanblog 内嵌的评论服务，有运行时。
>
> admin: Vanblog 后台面板，打包后为静态页面，无运行时。
>
> caddy: 作为对外的网关，按照规则反代上述几个服务，并提供全自动的 https。

### 进程依赖和启动关系

打包后，启动关系如图：

![架构图](./assets/vanblog.svg)

### 路径结构

本项目采用了 `pnpm` 作为包管理器，项目使用 `monorepo(pnpm workspace)` 组织和管理。

精简版目录结构：

```bash
├── docker-compose  # docker-compose 编排
├── Dockerfile  # Dockerfile
├── docs # 项目文档的代码
├── entrypoint.sh # 容器入口文件
├── LICENSE # 开源协议
├── package.json
├── packages # 代码主体
|  ├── admin # 后台前端代码
|  ├── server # 后端代码
|  ├── waline # 内嵌 waline 评论系统
|  └── website # 前台前端代码
├── README.md
└── pnpm-workspace.yaml # pnpm workspace 文件
```

### 技术栈

只列出大体上框架级别的，一些细节就直接看代码吧。

- 前台： [next.js](https://nextjs.org/)、[react.js](https://reactjs.org/)、[tailwind-css](https://tailwindcss.com/)
- 后台： [ant design pro](https://pro.ant.design/zh-CN/)、[ant design](https://ant.design/)
- 后端： [nest.js](https://nestjs.com/)、[mongoDB](https://www.mongodb.com/)
- CI： [docker](https://www.docker.com/)、[nginx](https://www.nginx.com/)、[github-actions](https://docs.github.com/cn/actions)
- 文档： [vuepress](https://vuejs.press/zh/)、[vuepress-theme-hope](https://theme-hope.vuejs.press/zh/)

## 本地开发

### 环境准备

#### 准备数据库

开发之前，要有一个 `mongodb` 数据库。推荐用 `docker` 起一个：

```bash
docker run --name mongodb-vanblog -d --restart unless-stopped \
  -p 27017:27017 mongo
```

#### node 要求

- nodejs 18
- pnpm v7+

#### 克隆项目并安装依赖

```bash
git clone https://github.com/Mereithhh/vanblog.git
cd vanblog
pnpm i
```

### 添加 server 配置文件

在 `packages/server` 下，创建 `config.yaml` 文件，内容如下：

```yaml
database:
  # 数据库连接
  url: mongodb://localhost:27017/vanBlog?authSource=admin
static:
  # 图床等静态文件保存的位置
  path: /var/vanblog-dev/static
# 是否开启演示站模式，会限制很多权限
demo: 'false'
# waline 用的表名，会自动创建
waline:
  db: waline
# 日志位置
log: /var/vanblog-dev/logs
```

### 开发相关命令

#### 开发全部

在根目录下：

```bash
# 开发全部（前台、后台、server）
pnpm dev
# 前台为 3001 端口
# server 为 3000 端口
# 后台为 3002 端口
```

::: info VanBlog开发后台如果用到复制到剪切板相关的功能，可能需要开启 `https`，请在 `packages/admin/config/config.js` 中的 `https` 改成 `true`，再重启开发进程。

```js
 devServer: { https: true, port: 3002 },
```

:::

#### 单独开发前后台（前端）

必须要先启动 server：

```bash
# 端口 3000
pnpm dev:server
```

然后在启动前台后者后台

```bash
# 启动前台 端口 3001
pnpm dev:website
# 启动后台 端口 3002
pnpm dev:admin
```

### 文档开发

根目录下：

```bash
pnpm docs:dev
```

端口号为: `8080`

## 镜像构建

直接在根目录用 `Dockerfile` 打包就行，具体看下面第二点。

### act（作者自用）

我一般会用 [act](https://github.com/nektos/act) 来做验证镜像，act 可以在本地运行 `Github Actions`。

这个方法需要 `.env` 文件存放密钥，目前仅自用。

```bash
pnpm build:test
```

### 手动打包

```bash
# 这个build server 是第一次打包镜像拿数据的，不写也行，那就得等启动容器后增量渲染生效了。
VAN_BLOG_BUILD_SERVER="https://some.vanblog-server.com"
docker build --build-arg VAN_BLOG_BUILD_SERVER=$VAN_BLOG_BUILD_SERVER -t mereith/van-blog:test .
```

## 文档发版

已经有了对应的 `github actions`，向远端推送 `doc*` 的 `tag` 会触发然后发布到项目官方。

有一键脚本可以在发版之后自动拷贝 changelog 并发布：

```bash
pnpm release-doc
```

## Release

本项目使用 [standard-version](https://github.com/conventional-changelog/standard-version) 管理版本，并有了对应的 `github actions`，执行下列命令会发布版本并触发流水线打包发版。

```bash
pnpm release
pnpm release-doc
```

开发指南

【logging】Python多层级日志输出

# 在Debian 12中安装自带nodejs 18.x

**摘要**: 在Debian 12中自带了 nodejs v18 ， 安装使用更加方便。  安装Node sudo apt install -y nodejs npm 安装配置VueJS3+Quasar 先安装基本程序： sudo npm install -g yarn@...



在Debian 12中自带了 nodejs v18 ， 安装使用更加方便。

## 安装Node

```sh
sudo apt install -y nodejs npm
```

安装配置VueJS3+Quasar

先安装基本程序：

```sh
sudo npm install -g yarn@latest nrm  --registry=http://registry.npmmirror.com
```

nodejs切换taobao源

使用nrm工具切换淘宝源

```sh
npx nrm use taobao
```

如果之后需要切换回官方源可使用

```sh
npx nrm use npm
```

> 不再使用下面的命令：
>
> ```sh
> sudo yarn config set registry https://registry.npm.taobao.org/
> ```
>
> 另外注意上面的域名已经改变。使用命令可以避免域名修改的问题。使用旧域名会出现    npm ERR! request to <https://registry.npm.taobao.org/xxx> failed, reason: certificate has expired
>
> 其实，早在 2021 年，淘宝就发文称，npm 淘宝镜像已经从 <http://registry.npm.taobao.org> 切换到了   <http://registry.npmmirror.com。旧域名也将于> 2022 年 5 月 31 日停止服务（直到 HTTPS  证书到期才真正不能用了）

2024年1 月 22 日，淘宝原镜像域名（<http://registry.npm.taobao.org）的> HTTPS 证书正式到期，导致旧的 npm 淘宝镜像在使用时出错了。

其它包可根据情况按全局安装，或在项目中安装。全局安装VueJS 3与Quasar至用户目录：

```sh
yarn global add @vue/cli
yarn global add @quasar/cli
```

新建项目

找vue找不到， 在 \~/.yarn/bin/vue

```sh
vue create .
```

yarn 创建：

```sh
yarn create vue name
```

开始使用：如果已经有项目，直接在项目中安装所需包即可：

```sh
yarn install
```

按如下命令运行开发环境， vite 方式：

```sh
yarn quasar dev
```

或（webpack）方式：

```sh
yarn quasar serve
```

相关命令，在项目中运行：

```sh
yarn global list
vue info
quasar info
```

## 旧版本中安装

在较低版本的Debian中安装nodejs v18麻烦一些。以下基于Debian 11 的安装经验。可参考。

检查当前版本：

```sh
bk@v3:~$ node -v 
v16.15.0
```

如果已经安装nodejs， 并且版本不是18.x，则先卸载掉。

```sh
sudo apt purge nodejs
sudo apt update && sudo apt -y dist-upgrade && sudo apt -y autoclean && sudo apt -y autoremove
```

按如下步骤安装Nodejs 18.x

```sh

# 添加NodeSource APT存储库和用于验证软件包的PGP密钥
sudo apt install -y apt-transport-https curl ca-certificates software-properties-common

# 完成apt-get存储库的添加并添加了PGP密钥
curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -

## 容器运行
podman run --rm -it -v `pwd`:/ws node:lts-alpine sh -c 'cd /ws && yarn'
```

**本文链接:**[在Debian 12中安装自带nodejs 18.x](http://www.osgeo.cn/post/10f26)
**版权所有:** 非特殊声明均为本站原创文章，转载请注明出处： [开源地理空间基金会中文分会](http://www.osgeo.cn)

【转载】在Debian 12中安装自带nodejs 18.x

[身份验证](https://docs.github.com/zh/authentication)/[使用 2FA 保护你的帐户](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa)/

# 关于双重身份验证

[原始链接](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication)

双重身份验证 (2FA) 是登录网站或应用时使用的额外保护层。启用 2FA 时，必须使用您的用户名和密码登录，并提供另一种只有您知道或可以访问的身份验证形式。



## 本文内容

- 双重身份验证恢复代码
- 在你的组织中要求进行双因素身份验证

**注意：**从 2023 年 3 月开始到 2023 年底，GitHub 将逐渐开始要求在 GitHub.com  上贡献代码的所有用户启用一种或多种形式的双因素身份验证 (2FA)。  如果你在符合条件的组中，当选择该组进行注册时，将收到一封通知电子邮件，该电子邮件标志着 45 天的 2FA 注册期的开始，并且你会看到要求你在  GitHub.com 上注册 2FA 的横幅。 如果未收到通知，则表示你不是需要启用 2FA 的组的成员，但我们强烈建议启用 2FA。

有关 2FA 注册推出的详细信息，请参阅[此博客文章](https://github.blog/2023-03-09-raising-the-bar-for-software-security-github-2fa-begins-march-13)。

对于 GitHub 来说，第二种身份验证形式是一个由移动设备上的应用程序生成的或者以短信 (SMS) 形式发送的代码。 在启用 2FA  后，只要有人尝试登录你在 GitHub.com 上的帐户，GitHub 就会生成验证码。  用户能登录你的帐户的唯一方式是，他们知道你的密码，且有权访问你手机上的验证码。

配置 2FA 后，可以通过基于时间的一次性密码 (TOTP) 移动应用或短信添加安全密钥，例如 FIDO2 硬件安全密钥、Apple  Touch ID 或 Windows Hello。 启用安全密钥身份验证的技术称为 WebAuthn。 WebAuthn 是 U2F  的继承者，适用于所有现代浏览器。 有关详细信息，请参阅“[WebAuthn](https://webauthn.guide/)”和“[是否可以使用](https://caniuse.com/#search=webauthn)。”

可以选择将密钥添加到帐户。 密钥类似于安全密钥。 不过，密钥同时满足密码和 2FA 要求，因此通过一个步骤即可登录到帐户。 如果你已配置了符合密钥条件的 2FA 安全密钥，则在密钥注册期间，系统可能会提示你将安全密钥升级到密钥。有关详细信息，请参阅“[关于密钥](https://docs.github.com/zh/authentication/authenticating-with-a-passkey/about-passkeys)”和“[管理密钥](https://docs.github.com/zh/authentication/authenticating-with-a-passkey/managing-your-passkeys)”。

你还可以在配置 TOTP 移动应用或短信后使用 GitHub Mobile 进行 2FA。 GitHub Mobile 使用公钥加密来保护你的帐户，允许你使用用于登录 GitHub Mobile 的任何移动设备作为第二重身份验证。

您还可以配置其他恢复方法，以防无法访问双重身份验证凭据。 有关设置 2FA 的详细信息，请参阅“[配置双重身份验证](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)”和“[配置双重身份验证恢复方法](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods)”。

注意：如果无法使用任何恢复方法，表示已永久失去对帐户的访问权限。 但是，可以取消链接已绑定到锁定帐户的电子邮件地址。 然后，可以将已取消链接的电子邮件地址链接到新的或现有的帐户。 有关详细信息，请参阅“[从锁定的帐户取消链接电子邮件地址](https://docs.github.com/zh/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account)”。

为确保帐户安全，强烈建议启用 2FA，不仅在 GitHub 上启用，在支持 2FA 的其他网站和应用上也要启用。 您可以启用 2FA 以访问 GitHub 和 GitHub Desktop。

有关详细信息，请参阅“[使用双重身份验证访问 GitHub](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication)”。

## [双重身份验证恢复代码](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication#two-factor-authentication-recovery-codes)

配置双重身份验证时，您将下载并保存双重身份验证恢复代码。 如果无法访问您的电话，您可以使用恢复代码向 GitHub 验证。 有关详细信息，请参阅“[丢失 2FA 凭据时恢复帐户](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials)”。

警告： 出于安全原因，如果你丢失了双重身份验证的凭据或无法访问你的帐户恢复方法，GitHub 支持人员[将无法恢复访问启用了双重身份验证的帐户](https://docs.github.com/zh/site-policy/other-site-policies/github-account-recovery-policy)。 有关详细信息，请参阅“[丢失 2FA 凭据时恢复帐户](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials)”。

## [在你的组织中要求进行双因素身份验证](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication#requiring-two-factor-authentication-in-your-organization)

组织所有者可要求组织成员、帐单管理员和外部协作者使用双因素身份验证保护其个人帐户。 有关详细信息，请参阅“[在你的组织中要求进行双因素身份验证](https://docs.github.com/zh/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization)”。

按 alt+up 激活

## 帮助和支持

## [使用安全密钥配置双重身份验证](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key)

并非所有 FIDO 验证器都可以用作密钥，但仍可将这些验证器注册为安全密钥。 安全密钥也是 WebAuthn 凭证，但与密钥不同，安全密钥不需要用户验证。 由于安全密钥只需要验证用户状态，因此仅算作第二个因素，必须与密码结合使用。

使用 TOTP 应用程序或短信启用 2FA 后，即可为帐户注册安全密钥。 如果您丢失了安全密钥，仍可以使用手机的代码进行登录。

1. 必须已通过 TOTP 移动应用 或通过 SMS 配置了 2FA。
2. 确保已将兼容 WebAuthn 的安全密钥插入到设备中。
3. 在 GitHub 任意页的右上角，单击个人资料照片，然后单击“**设置**”。
4. 在侧边栏的“访问”部分中，单击“

 密码和身份验证”。

在“安全密钥”旁边，单击“添加”。

![2FA 设置的“双因素方法”部分的屏幕截图。 标有“添加”的灰色按钮以橙色框突出显示。](https://docs.github.com/assets/cb-33660/images/help/2fa/add-security-keys-option.png)

在“安全密钥”下，单击“注册新安全密钥”。

键入安全密钥的昵称，然后单击“添加”。

按照安全密钥的文档说明，激活安全密钥。

确认您已下载并且能够访问恢复代码。 如果尚未下载，或者要生成另一组代码，请下载代码并将其保存在安全位置。 有关详细信息，请参阅“[配置双重身份验证恢复方法](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods#downloading-your-two-factor-authentication-recovery-codes)”。

## [使用密钥配置双因素身份验证](https://docs.github.com/zh/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-passkey)

使用密钥，无需输入密码，即可安全地登录到 GitHub。 如果使用双因素身份验证 (2FA)，则密钥同时满足密码和 2FA 要求，因此只需一个步骤即可完成登录。 也可以将密钥用于 sudo 模式并重置密码。

**注意：** 平台身份验证器（如 Windows Hello、Face ID 或 Touch ID）可以改而注册为密钥。

有关详细信息，请参阅“[关于密钥](https://docs.github.com/zh/authentication/authenticating-with-a-passkey/about-passkeys)”。

1. 必须已通过 TOTP 移动应用 或通过 SMS 配置了 2FA。
2. 在 GitHub 任意页的右上角，单击个人资料照片，然后单击“**设置**”。
3. 在侧边栏的“访问”部分中，单击“

 密码和身份验证”。

在“密钥”下，单击“添加密钥”。

如果出现提示，请使用密码进行身份验证，或使用其他已有的身份验证方法。

在“配置无密码身份验证”下，查看提示，然后单击“添加密钥”。

在提示符下，按照密钥提供程序概述的步骤操作。

在下一页上，查看确认密钥已成功注册的信息，然后单击“完成”。

关于github双重验证的文章

# 【转载】7-Zip 常用压缩/解压缩命令行指令

## 压缩

### **创建一个基础压缩包**

```bash
7z a archives.7z *.txt
```

### **创建带密码的压缩包**

```bash
7z a archives.7z -p123456 -mhe *.txt

7z a archives.7z -p"passwd@7z" -mhe *.txt
```

- `-p` 参数后跟着密码，如果密码有特殊字符，需要用双引号包裹。
- `-mhe` 参数设置同时加密文件名。

### **创建压缩包后删除原文件**

```bash
7z a archives.7z *.txt -sdel
```

### **创建的压缩包保留文件路径**

保留文件路径，以便解压缩时还能将文件解压到原处。

```bash
7z a archives.7z -spf /tmp/1.txt a/2.txt
```

对应的解压缩命令

```bash
7z x archives.7z -spf
```

- 解压缩时如果文件存在会弹出确认
- 解压缩时如果原目录不存在则会自动创建

### **指定不同的压缩包类型**

```bash
7z a -tzip a.zip 1.txt
```

- 可选值：`7z`、`xz`、`zip`、`split`、`gzip`、`bzip2`、`tar` 等

### **指定压缩包大小**

如果通过网页上传的归档有大小限制，可以将归档拆分为多份。

```bash
7z a archives.7z *.txt -v10m
```

格式为 `archives.7z.001`、`archives.7z.002` 等

- 注意事项：压缩过程中切不可移动 “已生成的” 归档，即使是 `.001` 号归档也可能在生成过程中被动态更新。
- 解压缩时候需解压首个 Volume  `7z e archives.7z.001`。

## 解压

### **基础解压缩**

解压缩到当前目录

```bash
7z e archives.7z
```

### **解压缩到指定路径**

```bash
7z e archives.7z -o/tmp
```

### **解压带密码的压缩包**

```bash
7z e archives.7z -p123456
```

### **解压缩时保留解压缩文件的相对路径**

假设压缩包内文件如下 `a\b\c\1.txt`，使用 `e` 解压缩，*1.txt* 会直接出现在当前目录下，不会保留 `a/b/c` 层级。

```bash
7z e archives.7z a/b/c/\*.txt
```

如果需要保留压缩包内路径，使用 `x` 命令，解压缩后，文件会保存到当前目录下的 `a/b/c/1.txt`。

```bash
7z x archives.7z a/b/c/\*.txt
```

### **解压缩指定内容**

只解压缩部分文件，可以使用如下命令。

```bash
$ 7z e archives.7z \*.txt -r

# 等同于
$ 7z e archives.7z "*.txt" -r
```

- `-r` 参数是递归查找压缩包目录下所有匹配的文件。
- 同样可以使用 `x` 命令，保留解压出来文件的路径。

### **解压缩覆盖无需确认**

```bash
7z x archives.7z -y
```

## 查看

### **查看压缩包内文件信息**

```bash
7z l archives.7z
```

没有使用 `-mhe` 加密的压缩包可以看到文件名。

```bash
   Date      Time    Attr         Size   Compressed  Name
------------------- ----- ------------ ------------  ------------------------
2022-11-30 19:46:27 ....A          700           48  1.txt
2022-11-30 19:46:45 ....A         2356               2.txt
------------------- ----- ------------ ------------  ------------------------
2022-11-30 19:46:45               3056           48  2 files
```

使用 `-mhe` 参数加密的压缩包首先需要输入密码，否则无法查看到任何内容。

### **查看压缩包详细信息**

```bash
7z l -slt archives.7z
```

输出

```bash
7-Zip [64] 17.04 : Copyright (c) 1999-2021 Igor Pavlov : 2017-08-28
p7zip Version 17.04 (locale=utf8,Utf16=on,HugeFiles=on,64 bits,4 CPUs x64)

Scanning the drive for archives:
1 file, 4920 bytes (5 KiB)

Listing archive: archives.7z

--
Path = archives.7z
Type = 7z
Physical Size = 4920
Headers Size = 174
Method = LZMA2:24
Solid = +
Blocks = 1

----------
Path = /tmp/1.txt
Size = 9
Packed Size = 4746
Modified = 2022-12-01 11:25:19
Attributes = A_ -rw-r--r--
CRC = ADD766B6
Encrypted = -
Method = LZMA2:24
Block = 0

Path = a/2.txt
Size = 13931690
Packed Size =
Modified = 2022-12-01 10:20:24
Attributes = A_ -rw-r--r--
CRC = 232240F1
Encrypted = -
Method = LZMA2:24
Block = 0
```

## 参考

- [Command Line Version User's Guide](https://sevenzip.osdn.jp/chm/cmdline/)

- [7-Zip 常用压缩/解压缩命令行指令](https://blog.yasking.org/a/terminal-7z-usage.html)


title: 开发指南 icon: signs-post order: 7

【logging】Python 多层级日志输出

1. 简介

在Debian 12中安装自带nodejs 18.x

关于双重身份验证

【转载】7-Zip 常用压缩/解压缩命令行指令

压缩

**创建一个基础