NestJS 11 迁移指南

升级依赖包

你可以手动更新依赖包，但官方推荐使用 npm-check-updates (ncu) 进行自动更新，以简化升级过程。

Express v5 迁移

Express v5 于 2024 年正式发布，并在 2025 年成为稳定版本。在 NestJS 11 中，Express v5 现在是默认集成的版本。

路由匹配规则变更

Express v5 调整了路径匹配算法，主要变更包括：

1. 通配符 * 必须带名称：

• 旧语法（Express v4）：/*
• 新语法（Express v5）：/*splat 或 /{*splat}（splat 只是一个变量名，可以自定义）

2. ?（可选参数）不再支持：

• 旧语法：/:file?.ext
• 新语法：/:file{.:ext}

3. 正则表达式字符不再支持。
4. 部分特殊字符需要转义（如 ()[]?+!）。
5. 参数名必须是合法的 JavaScript 标识符，或使用 :"paramName" 进行引用。

1
2
3
4
5
6
7
8
9
10
11

// 旧方式（Express v4）
@Get('users/*')
findAll() {
  return '此路由在 Express v5 可能无法正常工作';
}

// 新方式（Express v5）
@Get('users/*splat') // 需要给通配符命名
findAll() {
  return '此路由在 Express v5 可正常工作';
}

⚠ 注意：

• *splat 只是一个占位符名称，可以随意更改，如 *wildcard。

• 如果你希望匹配 根路径，需要使用 /{*splat} 语法：

中间件路径调整

在 Express v5 中，如果你有适用于所有路由的中间件，需要更新路径：

1
2
3
4
5

// 旧方式（Express v4）
forRoutes('*'); // Express v5 可能不兼容

// 新方式（Express v5）
forRoutes('{*splat}'); // 现在推荐的方式

Express v5 的查询参数解析变更

适用于 Express v5

• 之前，Express 默认使用 qs 库解析查询参数，支持嵌套对象和数组。

• 现在，默认使用 简单解析器，不再支持嵌套对象和数组。

例如，以下查询字符串：

1
2

?filter[where][name]=John&filter[where][age]=30
?item[]=1&item[]=2

在 Express v5 不会被正确解析。

如何恢复原行为:

1
2
3
4
5
6
7
8
9
10

import { NestFactory } from '@nestjs/core';
import { NestExpressApplication } from '@nestjs/platform-express';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create<NestExpressApplication>(AppModule);
  app.set('query parser', 'extended'); // 重新启用 qs 库解析方式
  await app.listen(3000);
}
bootstrap();

Fastify v5 迁移

NestJS 11 现在默认支持 Fastify v5：

• 几乎无痛升级，大部分用户无需调整。

• 路径匹配规则未变，通配符 * 仍然适用。

中间件注册调整

Fastify v5 不再支持 (.*) 语法匹配所有路径，需使用 命名通配符：

1
2
3
4
5

// 旧方式（Fastify v4）
.forRoutes('(.*)');

// 新方式（Fastify v5）
.forRoutes('*splat');

splat 只是一个占位符名称，可自定义。

模块解析算法优化

变更点

• NestJS 10 及之前：使用 哈希计算 来标识动态模块。

• NestJS 11：改为 对象引用，提升性能，减少内存占用。

⚠ 影响

• 以前，重复导入相同的动态模块会 自动去重。

• 现在，如果你希望模块 共享相同实例，需要手动管理：

1

const myModule = DynamicModule.forRoot({});

生命周期钩子执行顺序调整

• 之前，OnModuleDestroy、OnApplicationShutdown 等 按初始化顺序执行。

• 现在，执行顺序反转（与初始化顺序相反）。

示例：

1
2

// A 依赖 B，B 依赖 C
A -> B -> C

• 模块初始化顺序：C -> B -> A

• 模块销毁顺序：A -> B -> C（反转）

⚠ 影响：

全局模块 被视为依赖所有模块，因此 最先初始化，最后销毁。

CacheModule 迁移

NestJS 11 的 @nestjs/cache-manager：

• 迁移至 Keyv，提供统一的 键值存储接口。

• Redis 配置方式变更：

旧方式（NestJS 10）:

1
2
3
4
5
6
7
8

CacheModule.registerAsync({
  useFactory: async () => {
    const store = await redisStore({
      socket: { host: 'localhost', port: 6379 },
    });
    return { store };
  },
}),

新方式（NestJS 11）

1
2
3
4
5

CacheModule.registerAsync({
  useFactory: async () => ({
    stores: [new KeyvRedis('redis://localhost:6379')],
  }),
}),

Node.js 版本要求

• Node.js 16 已不再支持（于 2023-09-11 结束生命周期）。

• Node.js 18 也被移除（安全支持将于 2025-04-30 结束）。

• NestJS 11 需要 Node.js 20 或更高版本。

⚠ 建议：

始终使用 最新的 LTS 版本 以获得最佳体验。

其他

Mau 是 NestJS 官方推出的云端部署平台：

• 一键部署到 AWS

• 环境变量管理

• 实时应用监控

• 无需管理基础设施

1
2
3
4
5

# 安装
npm install -g @nestjs/mau

# 部署
mau deploy

Logger 增强

• JSON 日志支持：ConsoleLogger 现在支持 JSON 格式的日志输出，适用于容器化环境。
• 自定义日志前缀：可以自定义日志前缀，并且支持重新启用颜色输出以便于本地开发。

1
2
3
4
5
6

const app = await NestFactory.create(AppModule, {
  logger: new ConsoleLogger({
    json: true,
    colors: true,
  }),
});

更灵活的微服务

• unwrap 方法：可以直接访问底层客户端实例，支持自定义操作。
• 事件监听：新增 on 方法，用于监听底层客户端的事件，如断开连接或错误。
• 状态观察流：新增 status 观察流，实时监控客户端实例的状态。

1
2
3
4
5
6
7

const connection = serviceRef.unwrap<NatsConnection>();
serviceRef.on<NatsEvents>('disconnect', () => {
  console.log('Client disconnected');
});
serviceRef.status.subscribe((status) => {
  console.log('Status:', status);
});

更快的应用启动

• 模块不透明键生成优化：通过使用对象引用而不是哈希生成模块键，显著提升了启动性能。

Express v5 和 Fastify v5 支持

• Express v5：更新了路径路由匹配算法，需要注意一些语法变化。
• Fastify v5：大多数用户应该可以平滑升级。

1
2
3
4

@Get('users/*splat')
findAll() {
  return 'This route will work in Express v5';
}

其他有价值的更新

• 终止生命周期钩子顺序反转：OnModuleDestroy 和 OnApplicationShutdown 的顺序被反转。
• CacheModule 更新：使用 cache-manager v6，支持 Keyv 作为统一的键值存储接口。
• 新的 ParseDatePipe：简化了日期处理。
• 微服务选项支持从 DI 容器提供：增加了灵活性。
• IntrinsicException：引入了不会自动记录框架日志的异常。
• @nestjs/cqrs 增强：支持请求范围的提供者和强类型的命令、事件和查询。
• Reflector#getAll 和 Reflector#getAllAndMerge：现在可以正确推断转换后的元数据类型。
• ConfigService#get 更新：现在以不同的顺序读取配置值，并引入了 skipProcessEnv 选项。

迁移指南

• 提供了详细的 迁移指南，帮助用户从 NestJS 10 平滑升级到 NestJS 11。

Ubuntu 上发送 SMTP 邮件，使用 mailx 和 Postfix 结合是一个常见的方式。以下是如何正确配置并通过 mailx 使用 SMTP 发送邮件的步骤。

1. 安装 mailx 和 Postfix
   确保你已经安装了 mailx 和 Postfix。

1
2

sudo apt update
sudo apt install mailx postfix

2. 配置 Postfix
   配置 Postfix 为通过外部 SMTP 服务器发送邮件。这里以 Gmail 为例，如果你使用其他 SMTP 服务器（例如 Amazon SES），替换相应的配置信息。

修改 /etc/postfix/main.cf

编辑 Postfix 配置文件 /etc/postfix/main.cf：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# 设置SMTP服务器的标识符
smtpd_banner = $myhostname ESMTP $mail_name (Ubuntu)

# 禁用本地邮件提醒（通常用于本地用户终端的邮件通知）
biff = no

# 禁止在本地发送邮件时自动添加域名后缀
append_dot_mydomain = no

# 禁用 Postfix README 文档目录
readme_directory = no

# 设置Postfix兼容级别为3.6，以确保使用最新的默认行为
compatibility_level = 3.6

# TLS证书文件路径
smtpd_tls_cert_file=/etc/ssl/certs/ssl-cert-snakeoil.pem

# TLS私钥文件路径
smtpd_tls_key_file=/etc/ssl/private/ssl-cert-snakeoil.key

# 可选TLS安全级别，如果客户端支持TLS则使用
smtpd_tls_security_level=may

# 指定CA证书的路径，用于验证客户端证书
smtp_tls_CApath=/etc/ssl/certs

# 用于存储TLS会话缓存
smtp_tls_session_cache_database = btree:${data_directory}/smtp_scache

# 允许本地网络和经过SASL验证的客户端转发邮件
smtpd_relay_restrictions = permit_mynetworks permit_sasl_authenticated defer_unauth_destination

# 配置主机名，通常是服务器的FQDN（完全限定域名）
myhostname = localhost.localdomain

# 指定用户别名文件，用于邮件转发
alias_maps = hash:/etc/aliases

# 配置别名数据库
alias_database = hash:/etc/aliases

# 指定邮件的源地址（发送者域名）
myorigin = /etc/mailname

# 设置本地邮件的目的地（接收者域名）
mydestination = $myhostname, toimc.com, localhost.localdomain, localhost.localdomain, localhost

# 配置邮件中继服务器（Amazon SES SMTP服务器）
relayhost = [email-smtp.us-east-1.amazonaws.com]:587

# 指定可以访问的网络范围（通常为本地网络）
mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128

# 设置邮箱大小限制为0，表示不限制邮箱大小
mailbox_size_limit = 0

# 指定邮箱地址的分隔符，允许如user+info@example.com的邮箱地址格式
recipient_delimiter = +

# 监听所有网络接口，接受所有外部连接
inet_interfaces = all

# 启用IPv4和IPv6协议
inet_protocols = all

# 启用SMTP的SASL认证
smtp_sasl_auth_enable = yes

# 指定SASL认证的用户名和密码文件
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd

# 禁用匿名登录
smtp_sasl_security_options = noanonymous

# 强制使用TLS加密连接
smtp_tls_security_level = encrypt

# 记录STARTTLS的提供信息
smtp_tls_note_starttls_offer = yes

# 启用SMTP的TLS加密
smtp_use_tls = yes

# 禁用SMTPUTF8支持，避免与不支持该扩展的服务器出现兼容性问题
smtputf8_enable = no

3. (可选)创建~/.mailrc指定发送人：

1

set from=no-reply@toimc.com

4. 创建密码文件 vi /etc/postfix/sasl_passwd

类似下面的结构： [smtp.domain]:port username:password

例如：

1

[email-smtp.us-east-1.amazonaws.com]:587 AKIAT7WPVYWC25C2WBJW:你的SMTP密码

权限 sudo chmod 600 /etc/postfix/sasl_passwd

哈希 sudo postmap /etc/postfix/sasl_passwd

重启服务 systemctl restart postfix

5. 测试

1

echo "Test email body" | mail -s "这是一个邮件测试" yourmail@domain.com

常见的参数

分辨率

分辨率：屏幕分辨率是指纵横向上的像素点数，单位是px，常规：1920x1080，3840x2160，等；

常见的高清 = 540p = 960×540，超清720p = 1280x720，蓝光1080p=1920x1080，4K=3840x2160(4096×2160)

帧数(帧速率fps)

帧数：为帧生成数量的简称；帧率(Frame rate)=帧数(Frames)/时间(Time)，单位为帧每秒(f/s, frames per second, fps)；常见的帧数：

• 24P：电影标准
• 25P：PAL标准
• 30P：NTSC标准
• 60P：适合减慢做慢动作
• 120P：做更慢的慢动作（画质损失严重）

码流(比特率bps)

比特率是指每秒传送的比特(bit)数，也叫码率、码流。单位为 bps(Bit Per Second)，比特率越高，传送的数据越大，音画质越好。

码流(比特率) =采样率 x 采用位数 x声道数

或者

码流=文件大小（兆位）/视频持续时间（秒）例如：2400MBx8 / 480 秒 = 40Mbps

编码：所谓视频编码方式就是指通过压缩技术，将原始视频格式的文件转换成另一种视频格式文件的方式。

Wiki：视频流传输中最为重要的编解码标准有国际电联的H.261、H.263、H.264，运动静止图像专家组的M-JPEG和国际标准化组织运动图像专家组的MPEG系列标准，此外在互联网上被广泛应用的还有Real-Networks的RealVideo、微软公司的WMV以及Apple公司的QuickTime等。

文件名与编码不是对应的。

采样率

采样率（也称为采样速度或者采样频率）定义了每秒从连续信号中提取并组成离散信号的采样个数，它用赫兹（Hz）来表示。采样率是指将模拟信号转换成数字信号时的采样频率，也就是单位时间内采样多少点。一个采样点数据有多少个比特。

16位的声音和24位的画面基本已经是普通人类的极限了，更高位数就只能靠仪器才能分辨出来了。比如电话就是3kHZ取样的7位声音，而CD是44.1kHZ取样的16位声音，所以CD就比电话更清楚。举例：

• 电话：每秒3000次取样，每个取样是7比特，那么电话的比特率是21000。

• CD：每秒 44100次取样，两个声道，每个取样是13位PCM编码，所以CD的比特率是44100x2x13=1146600

  也就是说CD每秒的数据量大约是 144KB，而一张CD的容量是74分等于4440秒，就是639360KB＝640MB。

文件大小计算

计算输出文件大小公式：（音频编码率（KBit为单位）/8 +视频编码率（KBit为单位）/8）×影片总长度（秒为单位）=文件大小（MB为单位）

输出格式考虑维度

产品参数

IPhone 13 Pro

DJI Mavic Air2

DJI Mavic 3

素材参数

可以通过常见的软件查看视频素材的参数：

• MacOS：QuickTime Player
• Windows：PotPlayer

项目参数

以Final Cut Pro X为例：

针对特定的网站

B站

总览

参数要求

允许上传的格式：mp4,flv,avi,wmv,mov,webm,mpeg4,ts,mpg,rm,rmvb,mkv,m4v

• 网页端、桌面客户端推荐上传的格式为：mp4,flv

网页端上传的文件大小上限为8G，视频内容时长最大10小时

视频平均码率不超过6000kbps(H264/AVC编码)

• 推荐视频码率：1080p大于6000kbps；4k大于20000kbps；8k大于40000kbps

分辨率最大支持 8192X4320

• 推荐视频分辨率：1920X1080 或者 3840X2160

音频采样率48000Hz

• 推荐音频码率：320kbps

逐行扫描

智能识别输出HDR

智能识别全景视频

关键帧平均至少10秒一个

色彩空间

位深8bit

声道数≤2

采样率=44100

B站说明：

https://www.bilibili.com/read/cv527957/

Youtube

帧速率

内容应以录制时的帧速率进行编码和上传。

常用的帧速率包括 24、25、30、48、50 和 60 帧/秒（其他帧速率也可接受）。

隔行扫描的内容在上传之前应进行反交错处理。例如，分辨率为 1080i 且帧速率为 60 的内容应反交错处理为分辨率为 1080p 且帧速率为 30 的内容。每秒 60 个隔行扫描场应当反交错处理成每秒 30 个逐行扫描帧。

建议您在上传时采用以下比特率。音频比特率与视频分辨率没有关系。

比特率

上传 SDR 视频时推荐采用的视频比特率

要在 4K 分辨率下观看新上传的 4K 视频，请使用支持 VP9 的浏览器或设备。

上传 HDR 视频时推荐采用的视频比特率

上传时推荐采用的音频比特率

宽高比

YouTube 在计算机上的标准宽高比为 16:9。在上传其他宽高比（例如竖版或方形）的视频时，播放器会根据视频的尺寸自动调整自身的尺寸。此设置会根据宽高比和设备提供最佳的观看体验。

编码器

• 逐行扫描（请勿使用隔行扫描）
• 高配置
• 2 个连续 B 帧
• 闭合 GOP。GOP 为帧速率的一半。
• CABAC
• 可变比特率。无需限制比特率，不过我们在下面提供了推荐比特率，以供参考
• 色度二次抽样：4:2:0

音频编解码

• 声道：双声道立体声，或双声道 + 5.1 立体声
• 采样率：96khz 或 48khz

格式

• 不含编辑列表（否则视频可能无法正确得到处理）
• 文件以 moov atom 开头（快速开始）

慕课网

分辨率：1920x1080

码率：4000kbps 以上

帧率：30fps

声音：没有特殊要求，48kHZ -> 我个人觉得是不要有炸音，能听清楚就可以通过后期处理；

其他要求：VSCode + 24行代码显示

1.下载Centos镜像; 2.安装Parallels Desktop 17以上的版本；3.更换Centos源；4.解决冲突；5.安装Docker+Docker-compose；6.更换Docker源

下载Centos镜像

推荐无界面安装：

• CentOS-8-4-2105-aarch64-dvd-custom-202107301400.iso

  链接: https://pan.baidu.com/s/1fNLUXW7Ok2gWM8zzkTaz4g?pwd=c38j 提取码: c38j

  这里唯一注意的就是aarch64，这里对应M1芯片arm架构。

下载Parallels

两种方案：

• 使用macwk下载 + pd runner
• 正版购买（按年付 + 25%的折扣的优惠码），买断不适合macOS喜欢更新的小伙伴；

下载后，安装激活，并新建：

选择下载的iso路径，开始安装。

安装Centos

这里注意全程是命令行界面操作，需要设置的有：

• 安装位置确认；->输入5 -> 回车->再按提示c回车->一路按照提示；
• root用户密码；->输入8->回车->按照提示输入密码123456->弱密码yes->回车
• 创建用户；
• （可选）设置网络；

当上面的设置好了之后，按b，即可以开始安装了。

配置网络：

/etc/sysconfig/network-scripts目录下存放着网卡的配置文件，文件名称是ifcfg- 网卡名称：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

TYPE=Ethernet
PROXY_METHOD=none
BROWSER_ONLY=no
BOOTPROTO=dhcp
DEFROUTE=yes
IPV4_FAILURE_FATAL=no
IPV6INIT=yes
IPV6_AUTOCONF=yes
IPV6_DEFROUTE=yes
IPV6_FAILURE_FATAL=no
IPV6_ADDR_GEN_MODE=stable-privacy
NAME=ens33
UUID=a498f9b8-ffce-ace8-16fe-f4106a97f5bf
DEVICE=ens33
# 这里修改一下
ONBOOT=yes

如果使用dhcp自动获取ip，只需将ONBOOT=no修改为ONBOOT=yes即可。

如果是静态IP：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

TYPE=Ethernet
PROXY_METHOD=none
BROWSER_ONLY=no
BOOTPROTO=static   #将dhcp修改为stati表示使用静态ip
DEFROUTE=yes
IPADDR=192.168.0.10   #设置IP地址
NETMASK=255.255.255.0    #设置子网掩码
GATEWAY=192.168.0.1    #设置网关
DNS1=114.114.114.114     #设置dns
IPV4_FAILURE_FATAL=no
IPV6INIT=yes
IPV6_AUTOCONF=yes
IPV6_DEFROUTE=yes
IPV6_FAILURE_FATAL=no
IPV6_ADDR_GEN_MODE=stable-privacy
NAME=ens33
UUID=a498f9b8-ffce-ace8-16fe-f4106a97f5bf
DEVICE=ens33
#将no改为yes
ONBOOT=yes  

使用 nmcli c reload重启一下。

更换Centos源

基本思路：

• 删除所有官方源；
• 下载阿里源；

操作步骤：

1
2
3
4
5
6
7
8
9
10
11

cd /etc/yum.repos.d/

mkdir -p ../backup

mv ./Centos-Linux-* ../backup

wget -O /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-8.repo

yum makecache

yum -y update

解决冲突

Problem 1: problem with installed package podman

错误：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

[root@localhost ~]# sudo yum install docker-ce docker-ce-cli containerd.io
Failed to set locale, defaulting to C.UTF-8
Docker CE Stable - aarch64                                                                    669  B/s | 3.5 kB     00:05    
Error: 
 Problem 1: problem with installed package podman-3.3.1-9.module_el8.5.0+988+b1f0b741.aarch64
  - package podman-3.3.1-9.module_el8.5.0+988+b1f0b741.aarch64 requires runc >= 1.0.0-57, but none of the providers can be installed
  - package containerd.io-1.6.8-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.6.8-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - cannot install the best candidate for the job
  - package runc-1.0.0-66.rc10.module_el8.5.0+1004+c00a74f5.aarch64 is filtered out by modular filtering
  - package runc-1.0.0-72.rc92.module_el8.5.0+1006+8d0e68a2.aarch64 is filtered out by modular filtering
 Problem 2: problem with installed package buildah-1.22.3-2.module_el8.5.0+911+f19012f9.aarch64
  - package buildah-1.22.3-2.module_el8.5.0+911+f19012f9.aarch64 requires runc >= 1.0.0-26, but none of the providers can be installed
  - package docker-ce-3:20.10.17-3.el8.aarch64 requires containerd.io >= 1.4.1, but none of the providers can be installed
  - package containerd.io-1.4.10-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.10-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.11-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.11-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.12-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.12-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.13-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.13-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.3-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.3-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.3-3.2.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.3-3.2.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.4-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.4-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.6-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.6-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.8-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.8-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.9-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.4.9-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.5.10-3.1.el8.aarch64 conflicts with runc provided by 

解决办法：

1
2
3
4
5
6

yum erase podman buildah
 
# or
dnf remove podman buildah
 
dnf clean all && dnf check && dnf check-update

Problem 2: problem with installed package buildah

解决办法（同上）：

1
2
3
4
5
6
7

yum erase buildah

# or 
dnf remove buildah


dnf clean all && dnf check && dnf check-update

Problem: problem with installed package containers-common

错误：

1
2
3
4
5
6
7
8
9
10
11
12
13

[root@localhost ~]# sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Failed to set locale, defaulting to C.UTF-8
Last metadata expiration check: 0:01:24 ago on Mon Aug 29 09:35:22 2022.
Error: 
 Problem: problem with installed package containers-common-2:1-2.module_el8.5.0+890+6b136101.noarch
  - package containers-common-2:1-2.module_el8.5.0+890+6b136101.noarch requires runc, but none of the providers can be installed
  - package containerd.io-1.6.8-3.1.el8.aarch64 conflicts with runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - package containerd.io-1.6.8-3.1.el8.aarch64 obsoletes runc provided by runc-1.0.2-1.module_el8.5.0+911+f19012f9.aarch64
  - cannot install the best candidate for the job
  - package runc-1.0.0-56.rc5.dev.git2abd837.module_el8.3.0+569+1bada2e4.aarch64 is filtered out by modular filtering
  - package runc-1.0.0-66.rc10.module_el8.5.0+1004+c00a74f5.aarch64 is filtered out by modular filtering
  - package runc-1.0.0-72.rc92.module_el8.5.0+1006+8d0e68a2.aarch64 is filtered out by modular filtering
(try to add '--allowerasing' to command line to replace conflicting packages or '--skip-broken' to skip uninstallable packages or '--nobest' to use not only best candidate packages)

解决办法：

1
2
3

dnf remove -y containers-common-2:1-2.module_el8.5.0+890+6b136101

dnf clean all && dnf check && dnf check-update

安装Docker+Docker-compose

推荐使用daocloud加速源：

1
2
3
4
5
6

# 安装docker
curl -sSL https://get.daocloud.io/docker | sh

# 安装docker-compose
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.10.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

更换Docker源

两种方法：

• 一键配置
• 手动配置

一键配置：

1
2

# daocloud
curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s http://f1361db2.m.daocloud.io

手动配置：

1
2
3
4
5
6
7
8

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

上面的命令，其实就是在文件 /etc/docker/daemon.json 中写入如下内容：

1
2
3

{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}

• 科大镜像：https://docker.mirrors.ustc.edu.cn/
• 网易：https://hub-mirror.c.163.com/
• 阿里云：https://<你的ID>.mirror.aliyuncs.com，获取地址：https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors

然后，把docker服务重启了一下。

准备工作：

• 七牛云：免费版本的对象云存储就行了，有10G；

• Picgo：

  • GUI版本，下载地址：MacOS-Apple
  • MacOS-Intel
  • Windows-64；

• Typora：https://typora.io/，PS：下载Beta版本是免费的；

基本步骤

七牛云获取密钥

选择对应的产品：

点击立即试用，登录七牛云账号，点击新建：

注意空间名是小写+短横线，而博客一般会选择公开：

接下来就可以在：个人中心->密钥管理，来创建密钥，一个账户最多使用2个密钥。

下面把上面的AK,SK保存好，用于配置Picgo。

配置Picgo

下载Picgo之后，打开软件设置页面，点击图床设置，找到七牛云：

说明：

• AccessKey：对应AK
• SecretKey：对应SK
• 存储空间名：刚刚我们建立的，比如：toimc-public
• 访问网址：这个七牛云会默认生成一个，但是有效期是30天，最好是自己申请一个CV域名，走HTTPS；
• 存储区域：这里有一个区域列表，请查看

后续进阶：

可以安装一些常用的插件，awesome-picgo：

• 图片上传压缩picgo-plugin-compress：结合了tinypng，需要注册tinypng的账号，生成API；
• 图片路径修改picgo-plugin-rename-file：我个人的习惯是按照年月日+随机数进行划分。

配置Typora

这块是最简单的，打开Typora的配置，选择图像，按照如下配置：

接下来，当我们拷贝图片到Typora的时候，它就会自动使用PicGo上传到七牛云啦~

PS: 谈钱并不可耻，君子爱财取之有道。我们下面谈到的“副业”都是在国家法律法规范畴内，不投机不搞灰色产业（如币圈等），拒绝“黄赌毒”。

撰文人：我是Brian，9年副业+创业多元化的变现实战经验，百万级+内容创造者，大厂背景，全栈开发出身，多领域实操与项目经验。创立独立工作室，热爱分享技术。自认为非常有经验与实力来与大家交流分享，希望这些内容能帮助大家走出迷茫，找到方向。

说到副业，大多数的人非常功利心，觉得“副业”就是搞钱。谈“副业”就要聊有什么渠道、通过什么方式能赚钱，而且越“快”越好，越多越好——真有这好事，那不就闷声发大财，不会有人去分享的。要知道，同行有了竞争，久而久之就没有了利润空间。所以，真正“分享”的人要么收费（知识付费），要么就是图你的其他东西（比如渠道、信息、流量、名气等）。记住，人来人往皆为利往~说的这么功利，这就是现实，这些“发知识付费”财的博主们，也是卖的一种焦虑、一种满足于贪欲的情绪…

说点实在的，干副业干得好干成主业的人，都是非常自律而又方向非常明确的人，树立正确的价值观，对于走好副业道路非常重要。

副业=搞钱？

根据Mob研究院《2022年90后高收入人群洞察》，有70%的人没有开展副业，30%的人开展了副业。

很多小伙伴没有开始副业的原因：对于生活非常的迷茫，自己有一份相对安逸的工作和一颗怕丢脸、懒惰的心。一般会走向两个做副业的极端：不知道怎么开始和相做非常多的副业搞大钱。

迷茫的人：

先要正视一下自己，分析清楚当下的形势。举两个案例：

• 快40，未婚无子女无房，工作一般，想开始学习新的技术开始在外面接单。
  找到我的时候，直接就劝退他目前的这个方向了。首先，经济上不稳定，不能给家庭以保障；其次，年龄上比较大了，与年轻一代的去比拼接项目，肯定是吃亏的，弯道想要超车，需要付出成倍的努力——出师未捷身先死，可能就会病倒给家里带来负担；最后，他自己没有项目来源，技术也很一般，而且目前工作的学习时间不多。

状态分析：未明确自己现阶段最重要的事情，在危机来临的时候，急于找到“出口”而乱找方向。

我的建议是：1. 通过找关系送礼找一份相对稳定的工作进入到体制最好，这样可以有一份比较稳定的收入；再来准备自己的人生下一阶段，等结婚生育之后，再来考虑自己的兴趣问题；2. 因为该小伙伴学习过Python，可以从事Python相关的幼儿编程教育工作，收入不错，而且稳定。后续继续跟进…

• 35岁，一线大厂，育有一女，年收入20w，房贷月9k左右，有年龄危机。
  这位小伙伴是目前比较典型的案例了，做过一些副业的尝试（不是眼高手低的那种），但是收入都不行。碍于面子，没有在外面找项目去做。在35岁之前，走完了人生中最重要的几步：买房成家育子，老婆在家全职了3年之后，应该小孩子是上幼儿园了，所以又找了一份工作收入一般。尝试过卖书，也搞过一段时间的口播，但是收资不行。非常的迷茫，怕失去现在的工作后，生活的压力把自己的小家压垮了。

状态分析：有危机意识，生活经济上的压力不大，在当下最重要的事情是做好长远规划。

我的建议是：1. 可以参考抖音鱼皮的案例，走编程圈子的路线；2. 自己把下面一个阶段最重要的事情想清楚，平衡自己的家庭与事业，自己下面的发展可以根据自己的性格选择走管理或者继续走打工人的路线，同时做好二手准备（创业+降薪后面临的生活压力问题）；3. 不要有生活上的压力，3w的收入不一定比3k的收入的人要开心，即使没有工作了，去跑外卖一个月最差也有6-7的收入，跑快车一个月也有1w的收入；4. 走技术路线，找找相关的项目，同时积累人脉，找机会创业或者拿股份。

搞“大”钱的人：

很多人也许是出于生活的压力，也许是对美好未来的憧憬，也许是对家人的期许，也许是对孩子们的责任，让大家都像打了鸡血一样，连轴转，做着各种“副业”，乐此不彼。却没有停下过脚步去思考，去做长期规划。物质层面思考没有错，但是，一个人的时间是有限的，透支自己的精力，往往会带来身体+精神上的双重压力。

曾经的自己也是一个“奋青”，觉得自己的技术无所不能，也有非常多的软件项目的机会去赚钱，所以接了很多项目去做。虽然学习非常多的东西，但是自己身体也搞垮了。而且越到后面同质化的东西越多，能够学习的东西也变少了，让自己成了一个赚钱的机器。赚的再多的钱，没有了健康什么都白搭。

网络上，大多数摆在明面上的副业赚“大”钱的案例，除了极个别赚到了不错的收益，很多都没有赚到钱，营销要与商品本身配合的好，还要有运气。所以，我们的小伙伴们，要尽可能早的放弃对于爆红爆火的幻想。比如：现在来学现在就能赚钱、现在就想要有渠道、现在就要有销路…等我就赚“大”钱，这种不切实际的想法。急于求成，只会以小打小闹，失败告终。

大家也不能走极端，不能完全的躺平，要从现在明白这样一个道理：做副业并不是单纯的搞钱，做副业其实是一个长期积累的过程，赚钱只是水到渠成的事。把节奏放慢下来，边做边思考，做长期的规划才是正确的做法。做得长远的副业，是对一个人综合能力的考量，比如：运营能力、学习能力、反思能力、新事物的接受能力…等。尽早的有这种想法，为未来做好准备的人，才能在机会到来的时候，能抓得住它。

副业其实是一场修行

副业这场修行，要从两个方向来学习：时间管理&认知突破。

时间管理

这虽然是一个老生常谈的话题，但是做好的人很少。那原因是什么呢？主要原因是：行动力与习惯差，人的惰性太强，理性会控制不了自己的身体。

怎么提高自己的行动力？

• 结团行动，互相鼓励与监督
• 花钱克制自己，找人监督；
• 自我约束，告别手机，使用番茄学习法（20+20或者40+20这样灵活组合）；
• 自我约束 + 冥想 + 健身：后面的这两者是最常用的提升专注力的方法，后期有机会给大家分享。
  提高了行动力，接下来就是学习时间的管理了，按照计划行事：

理解时间是有长短的

这一点很好理解，每天的工作时长与休息时长是固定的，才能保证睡眠的同时赚到钱，身体是一切活动的本钱。所以，要尽可能的减少熬夜，减少透支自己的身体，减少那种单纯使用时间换金钱的工作内容的投入。

明白这一点，就知道为什么打工人赚钱不能致富了。因为打工人的服务对象是有限的，一个人不可能同时打几份工。服务的对象少了，也就赚的钱少了~

平时，也不要去浪费时间，每个人的一生的长短也是有一个大概的长度的，所以要珍惜现在，珍惜眼前人，活在当下。

时间可以复制

听时间能复制，是不是非常的荒谬？这里的时间的复制，主要是指利用现代的科学技术，把文字、声音、图片、视频留存下来了，通过复制这些内容，让更多的人受益。随时互联网技术的发展，如今人们生活消遣的方式变成了看手机，手机上大多数内容以短视频为主。接入视频，数字类型的商品的拷贝，成本几乎为零。所以，做好时间的复制，可以让更多的人接触到更优秀的内容。比如：当老师从讲台前走到镜头前，他的声音与画面，他的知识就会被更多人接受到。而一个好的老师，会影响到一个同学的一生。

同理，如果利用时间可以复制的特性，我们可能把自己现在从事的很多事情搬到网上，通过文字、声音、图片、视频的方式让更多的人看到用到，从而也可以从中谋取自己的利益。

购买别人的时间

购买时间其实就是雇人做事，让自己的精力放在最核心的事情上，最有价值的事情上，这样才能事半功倍。所有赚钱的事情，要上规模才能有几何效应。很多人赚着钱，怕来人把自己的生意给抢走了，或者不太相信雇的人，所以事事亲为，这样就回到了“时间有长短”的概念，自己的服务对象就有限，规模就会有上限。

找准自己的赛道，看看未来几年可能的发展态势，找更多的人加入到自己的团队，从0到1，其实并没有大家想像的那么难，创业先从注册公司开始。有可能很多小伙伴已经创业了，发现招人非常的难。是的，“千金难买寸光阴”，现在的HR招人非常的难，更何况是找到一个合适的人，这一点上需要投入的精力会占公司的2-30%，前期甚至更多。

时间的多元化收益

你会不会坐地铁的时候听歌看视频？你会不会在上厕所的时候刷小视频？你会不会在吃饭的时候刷微博看知乎掘金？…这些都是时间的多元化收益，虽然有的听起来看起来不是那么的“健康”（吃饭的时候应该认真一些）。

多元化收益是我们通过把同一份时间进行分拆让多个事情能够并行的一种手法，说人话就是：一心二用。哇，你这有点反人类啊？老师们从小就教导我们不能一心二用，为什么你要推荐大家一心二用呢？因为，很多平时我们的碎片时间其实是可以利用起来的，比如：上厕所发发闲鱼单、公交地铁上10站路看看自己感兴趣的视频（学习）、睡觉或者跑步的时候可以听听英语音乐学英语等。

认知突破

卖时间

副业赚点小钱，每个人都可以，只是你没有动力、没有动手，空有一个点子。其实，有很多低门槛的副业，像做骑手、点赞、砍单等来钱真的很快，只是有的人会觉得赚这点钱很不屑。这类特点是做不大，形成不了规模，收入不稳定。

这类的副业，最主要的特点是这个世界上最通用，且最容易卖的一种资源——时间。每个人的时间是有限的，所以决定你的上限。

那独立的个人就赚不到大钱了吗？当然有，比如一些行业里面的顶级智囊，享有资源与超强整合资源能力的人们，他们的服务对象可能只有极少数的人，但是这些极少数的人却给他们提供了无穷的财富，因为，他们提供的服务是极优的，给这些富人们大大地节约了时间。

卖能力

比单纯的卖时间，再进一个维度，就是把卖时间变成卖能力。

打磨自己的核心竞争力，并且要有一定的心理承受能力，因为用时间换钱变成用能力换钱的时候，这个世界会360度无死角的“鞭打”你。但是，随着一次次的打击，能力也会一次次的提升。

卖资源

比卖能力更进一步的，是卖资源，做资源的整合者，管理者。

一个好的创业者企业家，要有发现市场资源和消费者的尖锐眼光、行动力、专注力和毅力，才有可能成功。

朋友让你稳当点、父母让你早结婚、对象让你别做梦，让你放弃了一个又一个的机会和想法。等过了几年，在新闻上你看到了自己的点子成功了，你最多只能说一句“我要做我早成功了”。就像打牌一样，犹犹豫豫不敢下注，告诉自己只要我不上桌就没人能赢我的钱，也许你永远不会失去手中的筹码，但这就是一辈子所有的财富了。而你羡慕的那些人，一直坐到桌子上，不停的ALL IN（全押，风险越大收益越大，成规模才能赚钱），本来就一无所有，还怕失去什么呢。——这里要注意，创业不要借“高利”贷（年化低于6%都可以考虑）。

明白了时间管理的方法与找准认知突破的方向后，接下来就是具体的副业内容了。

根据前文统计报告，其中指出了超过一半的人想从事副业。躺赚是所有小伙伴心中的梦想——梦想很美好，但现实很骨感。有一些副业，听上去很高大上，而实际上的收入真是有那么赚钱？我们来看下。

副业真这么赚钱？

先说个结论：大多数副业是不怎么赚钱的，费精力。能把副业做成主业的，是有强大的兴趣+机遇+努力才能成功。

先要给小伙伴泼冷水了，那些看似光鲜的网络搞钱背后，大多是割韭菜。

其中，亲身经历过的就有：写作变现课、读书、播音…这些副业的投入产出比不大，所以，费时费人，急缺钱用，而且有时间，就可以做做跑腿（代驾、专车等），这种来钱快，有时间跑就有钱赚。

像在很多社区平台上流行的：

• 微商（前几年），主要的模式是发展下线，实质上自己带货赚的少，精力花费大；
• 游戏主播：这个不算是副业了，算是半个主业了，头部主播已经满额，后期想做出来难变现；参考变现做得好的：猫萌；
• 写作、播音、做图变现：这几个算是一类，大多是卖自己的课程，课程内容偏理论多一些，实操的不多。而真正变现的，会有，但是对个人能力要求高，性价比一般，需要有一个长期积累的过程，从业人数非常的多；要做差异化的东西，容易出圈，但是，做出来是比较难的；
• 短视频相关，如TikTok、带货、影视剪辑等：这一类算是技能型的副业，大多数人可以学，但是，没人会告诉你其中的坑。1. 门槛低，很多机构的从业者在学校就开始学习这些工具的使用，所以网络上同质的内容很多；2. 变现其实要考虑规模，一个人做大多数时候只会有几块几十每条视频（这个是非常不错的播放数据）的收入，所以真正做这个赚钱的：要么是有多个账号多平台+多设备发（这里会有手机+手机号成本的投入），要么是有上百万千万的粉丝做广告变现；
• 跑腿、代驾、点赞砍刀、代练等：这一类是投入多少时间就会有多长的回报，回报快但是无法持久回报。一个真实数据：一线城市，全职滴滴师傅，一般一个月休息2-4天，一周休息一天看天气与心情，收入大概在1w左右。其中，每天的收入400-600不等（夜班比白班赚的多100-200），还要除去一些成本：租车、吃饭、充电或者加气、车辆维修、偶尔会有违章等，基本一天的工作时长在10小时，夜班的时间会短一些。很多都会有职业病，干不特别长久，有很多师傅都会有自己回归实业的一些打算（做一做小生意）；
• …
  还有很多类似的案例，可能有一些案例我们同学们第一次听觉得很新奇，是不是？这种感觉就对了，兴趣是最好的老师，先动起来，去尝试才知道是否适合自己。而找到适合自己的，就跟上面我们在罗列这些副业一样，要让自己接触到更多的分类，了解市场&行情，这样才能做到“百战百胜”，这就是视野的重要性了。

做好副业要打开自己的视野，勇于去想去拼，才会有结果——PS：好鸡汤啊，好毒。

那有什么副业可以做呢？

同类型的问题还有：

• 什么样的副业才算是好副业呢？
• 怎样去开始自己的副业呢？
• 怎么提升自己的意识？
• …
  下面我们一起来探讨一下。

有哪些副业是好副业？

好副业的一些参考标准：

• 持续带来收入，投入产出比高，一份投入多份产出；
• 阳光行业，未来发展清晰；
• 和自己专业、工作、以往的经历有关，能够有先天的“资源”；
• 对应自己的兴趣，做事情有激情；
  那如何选择呢？有哪些具体的方向呢？

从兴趣出发

技术出生的人是比较容易开展自己的副业的，可选的方向比较多。

未来主要方向是：除了技术输出以外，还可以学习做一些兴趣相关的，“混搭”才更有料，比如：用视频的方式记录一个阳光宅男的生活、情景短片、科普视频等，即好玩又有趣，还学习了东西，交到了朋友，何乐而不为？ 程序员开展自己的副业，先要了解互联网行业的发展，这样可以初步确定一些朝阳行业或者方向，然后，从自己的兴趣出发，选择那些可以让自己忘记时间的事情着手，把兴趣变成职业应该是每个人追求的方向。

推荐：短视频社交、短视频科普等

从已有资源出发

有很多小伙伴本身在自己的行业中已经从业多年了，其实手上有很多资源（人脉、权力、货物、渠道等），想搞钱只是没有去往这方向想，或者想了之后，看到了很多人做的其实不好，自己就打了退堂鼓了。记住风险与机遇共存，风险越大对自己的挑战越大，同时回报也越大。我们可以不去赌，可以找人一起分担这个风险。如果自己不会，就找专业的人咨询；如果自己没有方向，就可以看看有没有同样的国内国外的同行在做的副业，学习商业模式，其实就可以很快上手了。因为你在自己的行业，其实是了解行业内幕的，无非是动手能力的强弱，以及产品&项目&方向上是否有竞争力。

推荐：专业咨询+多人合伙。

平凡的人最灵活

有的人时间很紧，没有什么时间——那就好好上班，如果精力还有，才考虑副业的问题，别“捡了芝麻丢了西瓜”；

有的人时间很多，却不知道做啥——从兴趣出发，找几个你关注的人或者熟悉的人，问问行业消息再作打算；

有的人想法多，却没有资金——写做一些小闭环或者从一些自己比较好切入的点（熟悉的）入手，这样会有成就感，也能积累做事的信心。做多了之后，“胆子”也会大一些，面对不确定性的时候，就会更加从容。每个人都害怕失败，所以习惯在自己的舒适区，有了想法，更要有勇气走出去；

有的人有资金，却没有动手能力——找专业的人合伙，你出钱他出力这是一条出路；找时间在网上充实自己，投资自己是收益率最高的投资，找机会去做项目投资（实体）；

常见问题

做副业经常会碰到突发事情，并不是掌握单一技能就能做的很顺，往往是多维度多方面的技能锻炼，我在副业+创业的过程中，踩过、碰过很多坑，也有在金钱和时间上等方面有损失。

• 费用问题：最开始做副业项目，很多时候，只想找到一个机会而已，并不在乎自己的利益，所以被压榨的很利害，赚的也比较少。

  解决方案：在最初协商的时候，订立合同而非口头承诺；相对大一点的项目，会收取预付款；确定阶段性的付款方式。

• 信息问题：没有合适的切入点，不确定在哪里找合作平台，或者在哪里获取一些副业信息。

  解决方案：在朋友圈中做好宣传，朋友介绍到的项目一般可信度都比较高；找行业内的头部平台，通过网站排名、统计信息、社群推荐等渠道来了解与比较，而且要具备一定的项目分析的能力，最后就是多去试了。

• 信用问题：无论是找公司、个人还是平台，都会存在信用问题。

  解决方案：找中介平台、找担保人、以公司名义来进行动作，所以，在外面做副业，最好是有一个自己的公司。

• 方法问题：技术出生的我，初期做事情会追求极致，给自己招来了很多不便，增加了沟通成本，也可能会告吹好的项目。

  解决办法：学会权衡的艺术，在质量与速度之间做好平衡，很多时候，我们看结果为导向，并不是看过程。

• 时间问题：工作与生活不能很好的协调，身体会因为长时间的透支而变差，这样会反过来影响到工作。

  解决办法：在疫情期间我购买了跑步机（目前月跑在4次左右，1次5公里，初期会多一些），平时在家会带着家人做做操，跑跑步、跳绳，这个频次不用太高，一周3次即可，还有就是大量饮水+吃营养素，定期体验（我有自己的牙医+健康师）。

• 心态问题：即使到了现在我也会有迷茫的时候，不清楚自己追求的东西、自己做事的方向是不对的。

• 解决办法：我们人这一生，除了低头做事，还要学会抬头看路，探寻自己人生的意义。

  • 阅读：我会阅读人文传记、历史科普、心理学、管理学、经济学相关的书籍，来充实自己的精神世界。

  • 善于倾听：也会通过社群社区的交流，找到自己的项目&产品缺点，及时调整。

  • 总结与计划：总结过往，勇于面对挫折与失败，重新启航，我会有长期5年计划 + 短期月度年度计划，给自己定义一个大的方向，做事更稳健更有目标感。

本系统是读书笔记，纯属回忆&总结。

新书《Vue.js设计与实现》作者是霍春阳，想通过博客记录一下自己学习过程中的心得与总结。

第1章 权衡的艺术

第1章：介绍了声明式与命令式的概念与性能区别，虚拟DOM性能以及Vue.js在设计之初对于运行时的考量。

调试技能是程序员的基础技能，学会调试程序：

• 可以方便的找到程序的入口
• 可以找到运行过程中的逻辑问题（Bug）
• 可以理解程序执行的逻辑
• 可以了解函数之间的调用关系
• …

调试原理

在node的命令中提供了一个参数--inspect-brk，或者--inspect=9100指定调试端口，通过加入这个inspect参数，即可以实现调试Node程序的目的。

例如，如果需要调试webpack：

1
2
3

node --inspect-brk ./node_modules/.bin/webpack
Debugger listening on ws://127.0.0.1:9229/42e65994-934b-470c-b531-347ba54c7ac8
For help, see: https://nodejs.org/en/docs/inspector

然后就可以打开chrome进行连接了：

如果提示Debugger Attached，说明调试连接成功:

结合VSCode

需要借助到vscode强大的调试功能（PS：webstorm等IDE的配置思路一致）

小齿轮快速添加

点击小齿轮默认添加node.js结果：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
  // 使用 IntelliSense 了解相关属性。 
  // 悬停以查看现有属性的描述。
  // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "pwa-node",
      "request": "launch",
      "name": "Launch Program",
      "skipFiles": [
        "<node_internals>/**"
      ],
      "program": "${file}",
      "outFiles": [
        "${workspaceFolder}/**/*.js"
      ]
    }
  ]
}

从上面的配置中可以读出一点信息：

• vscode调试是在Launch Program，打开一个程序，或者说运行一个程序
• 文件是哪个呢？${file}即你打开的.js文件

关于上面的配置信息可以参考：

• Lanch Configuration文档

• Launch.json属性文档

调试尝试：

手动添加脚本

自动生成的配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "type": "node",
  "request": "launch",
  "name": "Launch via NPM",
  "runtimeExecutable": "npm",
  "runtimeArgs": [
    "run-script",
    // 下面的一行调整成你的启动脚本
    "start:dev"
  ],
  "port": 9229,
  "skipFiles": [
    "<node_internals>/**"
  ]
},

打断点进行调试：

发起请求，就可以看到停到断点了：

还可以在调试Console中看到各种调试信息。

Webstorm配置

如图，原理一样，配置简单（点击放大）

步骤：

• 添加配置
• 选择npm
• 选择调试脚本
• 打上断点
• 开启调试

何为教育

目标

我们不能够放弃任何一个孩子，教育的目标就是让每一个孩子都能够获得人生的成功，并且能够快乐地拥有掌握幸福的能力。

本质

教育的本质在于改变孩子，帮助这些孩子变得更好、更幸福。教育的本质不在于面试他们，不在于筛选出来好的孩子放在一起。

这一点有点类似于孔夫子的“有教无类”，教育家是贩夫走卒都能培养。甚至有人还曾经走过弯路，干过坏事，没关系，来，我都教你，然后慢慢把你变成好人，这个才是教育的本质。

人才需求在变化

传统的人才要求：

• 简单的培训
• 有耐力

今天对人才的需求：

• 解决复杂问题
• 批判思维
• 创造力
• 人力管理
• 协作能力
• 高情商

因为对人才的需求变化了，所以我们的教育也要变化。

我们来看看萨米特高中是怎么做到的。

新的尝试

在萨米特高中，每个班级没有老师讲课，他们的办法：

• 把知识点 + 所有的课程列表提供给同学
• 老师出课题，是一个问题或者挑战，让同学们自己解决实际的问题

比如：

• 工业革命：产品的故事
• 电力屋：从工程师的角度去设计一个电力屋
• 亲爱的编辑 ：要求学生亲生扮演作者

“这些课题项目并非临时植入的，它们是学生的日常作业，深入探讨、规划、调研、制作模型、写作和大量的批判性思考，取代了单纯的授课，学生和老师一同完成这些课题……”最后这句话很重要，“它们不是甜品，它们是主菜。”

学习方法

项目式学习

目的：在于培养决策力，打造基于项目式的课程体系

方法：在网络上自觉基础知识，合作完成，综合应用学科知识

自主学习

能学会自主学习，有三个关键词：精通、自主与目标

我们今天的学生与线上课程的时间是冲突的，而且学生的自主性差，如果不需要听老师慢节奏的讲课 + 繁重的作业，让学生们自己追着课程上的话，那就是海阔凭鱼跃。

那怎么办？

• SMART原则：Specific特定的目标，Measurable，可衡量的；Achievable可以实现的；Relevant，现实的Time-bound，有时间要求的；

  不是放羊，而是要不断的确定目标，新目标，然后调整状态。

• 随机应变：如果这部分学不会，就继续学；如果已经学会了，那就继续往下走；

• 寻求挑战：不能只学自己会的东西，自己喜欢的，要学习自己不会的，挑战新的目标；

• 坚持不懈：学习不是一蹴而就，必须能够忍耐，能吃苦；

• 直面挫折：这次没有做好，不会不要紧，直面挫折，下次再来；

• 适时求助：真的不会了，找人问。

如何培养呢？

老师是关键性作用的，要不断地在学习的过程中强调这些特性。

我们作为老师，我们作为学校，要教给你的是这六样东西，学那些知识是你自己的事，你自己去想办法。但是我们要教给你的，是这六个素质。这六项素质教会你了，你就能够活到老学到老，你就能够真的知道学习是怎么回事了。

我们老讲“授人以鱼不如授人以渔”，这句话是中国的俗语。

但是什么才是那个打鱼的“渔”？我们过去觉得，解题思路就是打鱼的“渔”。不对，解题思路是那个“鱼”，就吃的那个鱼。但是学习的这种态度、这种精神、这种设定目标的方法，寻求挑战的这种状态，然后适时求助的这种方法论，这个才是真正能够帮助一个人活到老学到老的工具。

失败在哪种情况下是有意义的？

• 学到了东西，并且有动力再次尝试；——强调不用过度的担心失败

  e.g. : 打游戏，game over了，还可以重启；

• 失败不会永久地排队未来的可能性；——我们创造了特别大的面对失败的压力

  e.g. : 高考模拟考试作弊

有本书叫作《不管教的勇气》，那本书的作者就说：“如果一个家长不能够让孩子意识到他是为了自己学习，那么你使多大的劲儿都没用。”就是你最多把他逼迫得假装在学习。

反思式学习

认知：你知道很多东西

元认知：你知道自己知道哪些东西

如果你知道自己知道哪些东西，那么相应的，你也会知道自己不知道哪些东西，你对自己的认知，有一个边界的了解，这个叫作“元认知”。所以要培养孩子能够反思、能够知道自己该学习些什么东西、能够知道自己需要些什么，这个是非常重要的一件事。

如何实现的呢？

解除老师的改作业、教学等工作，而让老师成为一个导师，负责15-20人，带领学生参与打分的过程。

比如：说你的一个作业，是“旅行箱”这样的作业。做完了以后，让其他组的孩子给这组的学生打分。然后老师打出自己的分，再来跟孩子们校正。老师告诉孩子们为什么打这样的分、原因是什么，帮助孩子不断地修订自己打分的标准。逐渐你就会发现，孩子们学会了判断力。这种对于作品的判断能力，其实就是非常重要的反思的能力，它替代了老师下的那个评语。

目的：

• 同学们不用只专注于分数
• 能够从方法论的角度提出意见
• 观察自己的学习、观察他人的学习

最终，提高自己的元认知。

建立良好的人际关系

很多学霸走上社会后并不成功，原因就是学霸一辈子只相信自己的能力强就够了，他不需要跟别人合作。但是，能够令你成功的最重要的能力，并不是竞争的能力。

我们在这个社会上，你真的能够做出贡献，最核心的能力是合作的能力。

怎么让大家来建立人际关系呢？

通过问题引导 - GROW模型

• G（Goal setting）：代表确认员工业绩目标；

• R（Reality Check）是现状，要搞清楚目前的现状、客观事实是什么；寻找动因；

• O（Options）代表寻找解决方案；

• W （What? When? Who? Will? What should be done? When by whom and does the will exist to do it?） 代表制定行动计划和评审时间。

人际关系中非常关键的点：

• 每个人都可以寻求属于自己的成功，我们的成功无需建立在牺牲他人的利益之上。
• 人跟人的成功维度是极多的，绝不意味着你战胜了别人就能够成功，你把别人搞糟糕了你就可以成功。

任何一个团队，在组建的时候都会面临着建立期、激荡期、规范期和执行期，最后还有一个解散期。

很多团队刚建立的时候整天吵架，打得一塌糊涂，团队有激荡期是很正常的一件事。

为了能够更好地决策，他们引入了一套决策机制DPIV，把决策过程中的人分成了几个类型。

• D（Decision）就是决定者，这种人是做决定的；——把握方向

• V（Vote）有否决权的人——守住底线

• P（Proposal），可以提议案的人——有一定的知识储备，有基本的原则

• I（Input），就是你可以做意见提供者；——各种各样的思想

• MBI，是被通知的那一方。

  做一个决策的时候，通常团队里边就这五种人。

如何才算是做好了准备

评判标准

• 健全的人格
  • 依赖
  • 压力管理
  • 自我调节
• 入学准备
  • 自我认知
  • 共情和人际交往能力
  • 执行力，即SMART原则
  • 自我和对学校的看法
  • 成长型思维，把失败视作是学习的机会
  • 自我效能感，自我价值很高，也知道自己能做的事
  • 归属感，集体的归属感
  • 学校的重要性
• 毅力
  • 适应性
  • 能动性
  • 学术韧性
• 独立性和可持续性
  • 自主性
  • 好奇心
  • 目标感

具体做法

1. 设定一个目标，准备三套方案，保证实现该目标。原则：

   • 你想要怎样的生活？目标要基于对自我清晰的认知
   • 你想要做的事情必须是切实可行，而且有意义的
   • 在做选择前，一定要全方位的考虑可能性，你的决定一定要得到周围人与家里人的支持

2. 出于好奇心持续的学习：

• 知识仍旧很重要，要改变的是获取知识的方法；
• 通过自己最感举的内容找到与世界对接的入口
• 体验、探索、追求
• 发掘真实的兴趣
• 学会利用网络上的课程知识
• 终身学习

3. 专项技能培养，雇主希望在求职者身上看到的是：

• Leader Ship（领导力）
• 团队合作能力
• 沟通技巧
• 解决问题的能力
• 口头表达能力
• 较强的职业道德
• 主动性
• 定量分析能力
• 灵活性/适应性
• 专业技术能力
• 人际交往能力
• 计算机能力
• 注重细节的组织能力
• 开朗外向的性格
• 战略规划能力
• 创造力
• 举止得体
• 创业精神
• 敢于承担风险

通用技能有哪些

1. 文本分析

   • 主题、中心思想
   • 观点、目标
   • 主旨展开
   • 结构
   • 词汇选择

2. 作品展示

   • 精准表达
   • 使用多媒体沟通
   • 口头汇报

3. 调研

   • 提问题
   • 定义一个设计问题
   • 规划和开展调查
   • 提出假设

4. 分析和整合

   • 组织和展示信息
   • 识别模式和关联
   • 对比
   • 建模
   • 阐释数据/信息以提出有效这个点
   • 建立联系和进行看你方便
   • 评估论点
   • 评估不同的设计方案
   • 给出基于证据的解释

5. 说与听

   • 参与基于证据的讨论
   • 沟通的规范、积极倾听

6. 写作

   • 有力的这个点
   • 提供相关信息、对论点进行解释说明
   • 叙事
   • 反驳
   • 选择论据
   • 解释论据
   • 整合论据
   • 组织（过渡、连贯、结构）
   • 引入的结论

7. 资源使用

   • 选择相关的资源
   • 资源的背景调查
   • 整合不同的资源
   • 建模

TypeORM上手

在前置的篇章中《nestjs搭建通用业务框架（5）：数据库+配置》，我们有介绍如何集成TypeORM到我们的nest项目中。平时的使用，无非两种情况：

1. 我们清楚的知道数据库及表格设计，我们不想去建TypeORM的实体ts文件；
2. 我们清楚的知道实体类的字段类型，我们不想去建数据库，全交给ORM；

我们先来看第一种情况：

如何产生typeORM的实体类

typeorm-model-generator：

• 针对 mysql

  1	npx typeorm-model-generator -h localhost -d your-mysql-db -u root -x your-mysql-password -e mssql -o .

• 针对progres:

  1	npx typeorm-model-generator -h localhost -d postgres -u postgres -x !Passw0rd -e postgres -o .

参数说明：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

Usage: typeorm-model-generator -h <host> -d <database> -p [port] -u <user> -x
[password] -e [engine]

Options:
  --help                 Show help                                     [boolean]
  --version              Show version number                           [boolean]
  -h, --host             IP address/Hostname for database server
                                                          [default: "127.0.0.1"]
  -d, --database         Database name(or path for sqlite)            [required]
  -u, --user             Username for database server
  -x, --pass             Password for database server              [default: ""]
  -p, --port             Port number for database server
  -e, --engine           Database engine
          [choices: "mssql", "postgres", "mysql", "mariadb", "oracle", "sqlite"]
                                                              [default: "mssql"]
  -o, --output           Where to place generated models
                            [default: "./output"]
  -s, --schema           Schema name to create model from. Only for mssql
                         and postgres. You can pass multiple values
                         separated by comma eg. -s scheme1,scheme2,scheme3
  --ssl                                               [boolean] [default: false]

• -e 对应的数据库的类型
• -p数据库服务器的端口
• -d数据库的名称
• -u数据库的用户名
• -s为mssql与postgres设计的一个参数，可以设置schema的名称

比如，我们的项目中是这样用的：

由于事先已经建好了users这个表格，里面就只有id, username，password三个字段。

1

npx typeorm-model-generator -h localhost -d nest-common -u root -x 123456 -e mysql -o .

产生三个文件:

1
2
3
4
5

.
├── entities
│   └── Users.ts
├── ormconfig.json
└── tsconfig.json

这里只需要这个文件Users.ts，然后大家可以把这个文件放置到src/entities或者其他的src的目录中，重启项目。

Users.ts文件的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

import { Column, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';

@Index('username_Idx', ['username'], { unique: true })
@Entity('users', { schema: 'nest-common' })
export class Users {
  @PrimaryGeneratedColumn({ type: 'int', name: 'id' })
  id: number;

  @Column('varchar', { name: 'username', unique: true, length: 32 })
  username: string;

  @Column('varchar', { name: 'password', length: 255 })
  password: string;
}

后续，我们建议使用nest g res [Module-Name]的方式来进行创建基础的CURD + 文件结构。

下面再来看第二种情况：

关于配置entities路径

推荐配置src/config/devlopment.ts：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

import * as path from 'path';

export const resolve = (dir) =>
  path.join(path.resolve(__dirname, '../../'), dir);
// 这里大家可以打印一下路径
// __dirname： /Users/macos/Projects/nestjs/nestjs-common-template/dist/config
// 惊讶的发现，目录是dist目录中的config路径

export const config = {
  db: {
    // https://typeorm.io/#/connection-options/common-connection-options
    synchronize: true,
    logging: true,
    host: process.env.DB_HOST || '127.0.0.1',
    port: process.env.DB_PORT || 3306,
    username: process.env.DB_USER || 'root',
    password: process.env.DB_PASSWORD || '123456',
    database: process.env.DB_NAME || 'nest-common',
    // 这里对应的路径是 /Users/macos/Projects/nestjs/nestjs-common-template/dist/**/*.entity{.ts,.js}
    // 即 dist 目录中，所有以 .entity.ts 或者 .entity.js 结尾的文件
    entities: [resolve('dist') + '/**/*.entity{.ts,.js}'],
    extra: {
      connectionLimit: 30,
    },
  },
};

这里几个有意思的属性：

• synchronize：true代表会从entities属性产生SQL，并创建表格；

  如果，你的数据库中没有，那么则会创建表的SQL，并自动创建

  测试：

  1. 删除users表格
  2. 重启npm调试进程
  3. 刷新数据库，users表又回来了

• logging：true代表执行SQL会打印在控制台中

• entities：TypeORM读取的实体类的文件夹，及文件名。

快速创建CURD服务

官方nest g方案

使用命令nest g res users，默认回车：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

nest g res users
? What transport layer do you use? (Use arrow keys)
❯ REST API 
  GraphQL (code first) 
  GraphQL (schema first) 
  Microservice (non-HTTP) 
  WebSockets 
? Would you like to generate CRUD entry points? (Y/n) 
CREATE src/users/users.controller.spec.ts (566 bytes)
CREATE src/users/users.controller.ts (894 bytes)
CREATE src/users/users.module.ts (247 bytes)
CREATE src/users/users.service.spec.ts (453 bytes)
CREATE src/users/users.service.ts (609 bytes)
CREATE src/users/dto/create-user.dto.ts (30 bytes)
CREATE src/users/dto/update-user.dto.ts (169 bytes)
CREATE src/users/entities/user.entity.ts (21 bytes)
UPDATE src/app.module.ts (1150 bytes)

是不是很方便。

使用ORM步骤：

1. 打开users/entities/user.entity.ts，把之前生成的实体类加入进来，或者自己进行编辑。

2. 修改users/users.module.ts，导入ORM：

   1 2 3 4 5 6 7 8 9 10 11 12 13 14

   import { Module } from '@nestjs/common'; import { UsersService } from './users.service'; import { UsersController } from './users.controller'; import { Users } from './entities/user.entity'; // 这里导入 import { TypeOrmModule } from '@nestjs/typeorm'; @Module({ // 这里导入 imports: [TypeOrmModule.forFeature([Users])], controllers: [UsersController], providers: [UsersService], }) export class UsersModule {}

3. 修改users/users.service.ts文件，添加get请求，并通过ORM操作数据库：

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

   // ... import { InjectRepository } from '@nestjs/typeorm'; @Injectable() export class UsersService { constructor( // 这里添加了Repository @InjectRepository(Users) private readonly usersRepository: Repository<Users>, ) {} // ... async findAll() { // 返回usres表中的所有数据 return await this.usersRepository.find(), } // ... }

4. 添加users一条信息，并测试：localhost:3000/users GET请求

   1 2 3 4 5 6 7

   [ { "id": 1, "username": "123", "password": "123" } ]

   直接返回一个json数组。

nestjsx方案

1. 什么是nestjsx？

   一个致力于开发nestjs的扩展的github组织。

2. 为什么要用nestjsx?

   官方：NestJS可能是几年前Node.js社区发生的最好的事情之一，为广泛的后端开发方面提供了一个真正重要的架构解决方案。但是，尽管它允许有效地创建RESTful应用程序，但缺少了一个重要的CRUD脚手架功能，而这个功能在许多其他HTTP框架中是存在的。这就是Nestjsx/crud问世的原因。

3. nestjsx的各个包的作用是什么

   @nestjsx/crud - 核心包，它提供了@Crud()装饰器，用于端点生成、全局配置、验证、辅助装饰器（文档）。
   @nestjsx/crud-typeorm - TypeORM包，它为关系型数据库提供了带有CRUD数据库操作方法的基础TypeOrmCrudService
@nestjsx/crud-request - 请求生成器/解析器包，它提供了用于前端的RequestQueryBuilder类和用于内部处理和验证后端查询/路径参数的RequestQueryParser

上手使用：

1
2
3
4
5

# 安装
npm i @nestjsx/crud class-transformer class-validator

# 使用 TypeORM
npm i @nestjsx/crud-typeorm @nestjs/typeorm typeorm @nestjs/swagger

修改users.service.ts：

1
2
3
4
5
6
7
8
9
10
11

import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { TypeOrmCrudService } from '@nestjsx/crud-typeorm';
import { Users } from './entities/user.entity';

@Injectable()
export class UsersService extends TypeOrmCrudService<Users> {
  constructor(@InjectRepository(Users) repo) {
    super(repo);
  }
}

修改users.controller.ts：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

import { Controller } from '@nestjs/common';
import { UsersService } from './users.service';
import { Users } from './entities/user.entity';
import { Crud, CrudController } from '@nestjsx/crud';

@Crud({
  model: {
    type: Users,
  },
})
@Controller('users')
export class UsersController implements CrudController<Users> {
  constructor(public service: UsersService) {}
}

再次请求localhost:3000/users，结果与之前的相同。

前言

本篇主要的目的，是搭建一个高性能的web服务器，便于后续开展通用业务（鉴权）的开发。

深入fastify

以下列出的是 Fastify 已经实现的主要功能及原理：

• 高性能： 据我们所知，Fastify 是这一领域中最快的 web 框架之一，另外，取决于代码的复杂性，Fastify 最多可以处理每秒 3 万次的请求。
• 可扩展： Fastify 通过其提供的钩子（hook）、插件和装饰器（decorator）提供完整的可扩展性。
• 基于 Schema： 即使这不是强制性的，我们仍建议使用 JSON Schema 来做路由（route）验证及输出内容的序列化，Fastify 在内部将 schema 编译为高效的函数并执行。
• 日志： 日志是非常重要且代价高昂的。我们选择了最好的日志记录程序来尽量消除这一成本，这就是 Pino!
• 对开发人员友好： 框架的使用很友好，帮助开发人员处理日常工作，并且不牺牲性能和安全性。
• 支持 TypeScript ： 我们努力维护一个 TypeScript 类型声明文件，以便支持不断成长的 TypeScript 社区。

学习资料，推荐fastify中文网

改良性能

在阅读与实践本部分的时候，一定要清晰的清楚自己的目标：提升接口的性能。如果，在已经成型的nest(Express)项目中，如果要进行Express -> Fastify的操作，一定要注意Express的中间件与Fastify可能不兼容，会导致切换失败。所以，在最初设计框架的时候就应该考虑到两个框架的优缺点，来进行选择。

总结：Fastify对于初学者来说，学习成本与Express一致，所以建立直接上手。Express对于熟悉http模块的同学来说，上手成本低。对于性能有要求的场景，Fastify是大家不二的选择。

在nest中默认会使用Express框架，作为web服务器的底层服务。为了提升性能的需求，nest提供了其他库的兼容性，例如Fastify

Fastify的性能是优于Express的，见下表：

测试环境： EX41S-SSD, Intel Core i7, 4Ghz, 64GB RAM, 4C/8T, SSD.

方法：autocannon -c 100 -d 40 -p 10 localhost:3000 * 2, taking the second average

数据测试库fastify/benchmarks

集成步骤：

1. 安装依赖@nestjs/platform-fastify

   1	npm i --save @nestjs/platform-fastify

2. 配置适配器

   安装 fastify 后，我们可以使用 FastifyAdapter，修改src/main.ts文件

   1 2 3 4 5 6 7 8 9 10 11

   import { NestFactory } from '@nestjs/core'; import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify'; import { ApplicationModule } from './app.module'; async function bootstrap() { const app = await NestFactory.create<NestFastifyApplication>(ApplicationModule, new FastifyAdapter()); // 默认情况下，`Fastify`仅在 `localhost 127.0.0.1` 接口上监听 // 改成 0.0.0.0 接受其他主机上的连接 await app.listen(3000, '0.0.0.0'); } bootstrap();

3. 运行npm run start:dev，打开localhost:3000验证服务是否OK。

看Hello world，或者打印出来如下信息：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

[下午8:43:23] File change detected. Starting incremental compilation...

[下午8:43:23] Found 0 errors. Watching for file changes.

[Nest] 4682   - 2021/03/24 下午8:43:24   [NestFactory] Starting Nest application...
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] DatabaseModule dependencies initialized +44ms
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] TypeOrmModule dependencies initialized +1ms
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] ConfigHostModule dependencies initialized +0ms
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] AppModule dependencies initialized +0ms
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] ConfigModule dependencies initialized +1ms
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] ConfigModule dependencies initialized +0ms
[Nest] 4682   - 2021/03/24 下午8:43:24   [InstanceLoader] ConfigModule dependencies initialized +0ms
query: START TRANSACTION
query: SELECT * FROM `INFORMATION_SCHEMA`.`COLUMNS` WHERE `TABLE_SCHEMA` = 'nest-common' AND `TABLE_NAME` = 'typeorm_metadata'
query: COMMIT
[Nest] 4682   - 2021/03/24 下午8:43:25   [InstanceLoader] TypeOrmCoreModule dependencies initialized +118ms
[Nest] 4682   - 2021/03/24 下午8:43:25   [RoutesResolver] AppController {}: +8ms
[Nest] 4682   - 2021/03/24 下午8:43:25   [RouterExplorer] Mapped {, GET} route +3ms
[Nest] 4682   - 2021/03/24 下午8:43:25   [NestApplication] Nest application successfully started +3ms

就OK了。

关于路径别名

我们常见的用法，比如：@代表src

在nest项目中配置路径别名比较简单，可以在tsconfig.json中添加paths属性：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "compilerOptions": {
    // ....
    // 添加如下内容
    "paths": {
      "@/*": [
        "src/*"
      ],
    }
  },
  // ...
}

然后，重新使用npm run start:dev进行测试即可。

后面，项目目录再深，也好写文件路径了，再也不用看到../../../无穷无尽的关联路径了。

MySQL

docker run命令

配置了utf8的格式与utf8-bin的编码：

1

docker run -itd --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -p 3306:3306 -v /my/own/datadir:/var/lib/mysql lw96/mysql5.7

参数说明：

• some-mysql容器名称
• MYSQL_ROOT_PASSWORD设置的root用户的密码
• -p是指定宿主端口:容器内服务端口，默认3306
• lw96.mysql5.7这个是我自己封装的MySQL镜像，设置好了utf8的编码
• -v设置数据库文件的映射，把宿主机上的目录/my/own/datadir与容器内的/var/lib/mysql作关联关系

使用docker-compose

如果是docker-compose.yml脚本：

1
2
3
4
5
6
7
8
9
10
11
12

version: '3'
services:
  mysql:
    image: lw96/mysql5.7
    container_name: 'some-mysql'
    restart: always
    environment:
    - MYSQL_ROOT_PASSWORD=my-secret-pw
    volumes:
    - /my/own/datadir:/var/lib/mysql
    ports:
    - "3306:3306"

Progres

docker run命令

1

docker run -itd --name postgres_container --restart=unless-stopped -p 5432:5432 -v $pwd/postgres:/data/postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=changeme -e PGDATA=/data/postgres postgres

参数说明：

• postgres_container容器名称
• -p是指定宿主端口:容器内服务端口，默认5432
• POSTGRES_USER数据库用户，POSTGRES_PASSWORD数据库密码，PGDATA数据库在容器内的数据路径
• -v设置数据库文件的映射，把宿主机上的目录$pwd/postgres与容器内的/data/postgres作关联关系

使用docker-compose

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

version: '3.5'

services:
  postgres:
    container_name: postgres_container
    image: postgres
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-postgres}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-changeme}
      PGDATA: /data/postgres
    volumes:
       - postgres:/data/postgres
    ports:
      - "5432:5432"
    networks:
      - postgres
    restart: unless-stopped
  
  pgadmin:
    container_name: pgadmin_container
    image: dpage/pgadmin4
    environment:
      PGADMIN_DEFAULT_EMAIL: ${PGADMIN_DEFAULT_EMAIL:-pgadmin4@pgadmin.org}
      PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_DEFAULT_PASSWORD:-admin}
      PGADMIN_CONFIG_SERVER_MODE: 'False'
    volumes:
       - pgadmin:/root/.pgadmin

    ports:
      - "${PGADMIN_PORT:-5050}:80"
    networks:
      - postgres
    restart: unless-stopped

networks:
  postgres:
    driver: bridge

volumes:
    postgres:
    pgadmin:

上面的配置，会默认启动一个web的管理界面pgadmin，用于管理postgres数据。

• 访问postgres，使用navicat填入如下的信息：
  localhost:5432
  用户名: postgres (默认)
  密码：changeme（默认）
• 或者使用web浏览器进入PgAdmin
  网址：http://localhost:5050
  用户名: pgadmin4@pgadmin.org (默认)
  密码：admin（默认)

MongoDB

docker run命令

1

docker run -itd --name mongodb -p 27017:27017 -v /data/db:/data/db --restart=always -e MONGO_INITDB_ROOT_USERNAME=root -e MONGO_INITDB_ROOT_PASSWORD=changeme mongo

参数说明：

• mongodb容器名称

• -p是指定宿主端口:容器内服务端口，默认27017

• -v设置数据库文件的映射

• MONGO_INITDB_ROOT_USERNAME数据库初始的管理员用户名，MONGO_INITDB_ROOT_PASSWORD初始的管理员密码

使用docker-compose

1
2
3
4
5
6
7
8
9
10
11
12
13
14

version: '3'
services:
  mongo:
    image: mongo
    container_name: 'mongodb'
    restart: always
    environment:
    - MONGO_INITDB_ROOT_USERNAME=root
    - MONGO_INITDB_ROOT_PASSWORD=changeme
    volumes:
    - /home/mongo/data/db:/data/db
    - /etc/localtime:/etc/localtime
    ports:
    - "27017:27017"

基本的流程：

• 申请Github账号 —— OAuth应用
• 配置gitalk
• 申请Github - Token
• 配置自动化脚本
• 配置nginx（解决403问题）
• 测试

next配置gitalk

在next项目_config.yml中，已经有明确的配置项：

第一个地方，需要注意配置gitalk与其他评论工具的顺序以及默认的评论工具。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# Multiple Comment System Support
comments:
  # Available values: tabs | buttons
  style: tabs
  # Choose a comment system to be displayed by default.
  # Available values: disqus | disqusjs | changyan | livere | gitalk | utterances
  active: gitalk
  # Setting `true` means remembering the comment system selected by the visitor.
  storage: true
  # Lazyload all comment systems.
  lazyload: false
  # Modify texts or order for any navs, here are some examples.
  nav:
    gitalk:
     order: -2
    disqusjs:
     text: Load Disqus
     order: -1

第二个地方：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# Gitalk
# For more information: https://gitalk.github.io
gitalk:
  enable: true
  github_id: toimc # GitHub repo owner
  repo: toimc.github.io # Repository name to store issues
  client_id: c2d14f07d902bf339af2 # GitHub Application Client ID
  client_secret: a41a05429a0ca340152b13fccx48245674437ba7 # GitHub Application Client Secret
  admin_user: toimc # GitHub repo owner and collaborators, only these guys can initialize gitHub issues
  distraction_free_mode: true # Facebook-like distraction free mode
  # When the official proxy is not available, you can change it to your own proxy address
  proxy: /login/oauth/access_token # This is official proxy adress
  # proxy: https://cors-anywhere.herokuapp.com/https://github.com/login/oauth/access_token # This is official proxy adress
  # Gitalk's display language depends on user's browser or system environment
  # If you want everyone visiting your site to see a uniform language, you can set a force language value
  # Available values: en | es-ES | fr | ru | zh-CN | zh-TW
  language: zh-CN

上面的配置项中有几个需要说明的：

• client_id与client_secret是Github 的 OAuth 认证（下面会介绍）
• github_id与admin_user这里建议填一样，填成自己的github账号名（不是邮箱）
• proxy默认即是上面的地址，它其实会回调到这里https://github.com/login/oauth/access_token来，大家出403的问题，主要是由于跨域。

Github的OAuth 认证

前提是自己得有一个github账号，才能注册OAuth application，OAuth应用注册地址

gitalk自动初始化

原理：通过sitemap中的信息，请求github开放api达到自动产生issues的目的

基本的要求：github API需要请求token

申请github Token

我们需要使用 Personal access tokens 方式，这种方式限制每小时 5000 次，结合缓存功能，基本满足需求。

从 Github 的 Personal access tokens 页面，点击 Generate new token

安装npm依赖项

1
2
3
4
5

"hexo-generator-sitemap": "^2.1.0",

"md5": "^2.3.0",
"request": "^2.88.2",
"xml-parser": "^1.2.1"

安装命令：

1
2
3

npm i -D md5 moment request xml-parser

npm i -S hexo-generator-sitemap

配置sitemap

在根目录中创建sitemap_template.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  {% for post in posts %}
  <url>
    <loc>{{ post.permalink | uriencode }}</loc>
    {% if post.updated %}
    <lastmod>{{ post.updated.toISOString() }}</lastmod>
    {% elif post.date %}
    <lastmod>{{ post.date.toISOString() }}</lastmod>
    {% endif %}
    <date>{{ post.date }}</date>
    <title>{{ post.title + ' | ' + config.title }}</title>
    {# nunjucks 模版语法 https://github.com/mozilla/nunjucks #}
    <desc>{{ post.description | default(post.excerpt) | default(post.content) | default(config.description) | striptags | truncate(200, true, '') }}</desc>
  </url>
  {% endfor %}
</urlset>

修改根_config.yml

1
2
3
4
5
6

sitemap:
  path: sitemap.xml
  template: ./sitemap_template.xml
  rel: false
  tag: true
  category: false

生成sitemap.xml文件

1
2

hexo clean
hexo generate

根目录添加talk-auto-init.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302

const fs = require('fs');
const path = require('path');
const url = require('url');

const request = require('request');
const xmlParser = require('xml-parser');
const md5 = require('md5');

// 配置信息
const config = {
  username: 'toimc', // GitHub repository 所有者，可以是个人或者组织。对应Gitalk配置中的owner
  repo: "toimc.github.io", // 储存评论issue的github仓库名，仅需要仓库名字即可。对应 Gitalk配置中的repo
  token: 'xxxxxx', // 前面申请的 personal access token
  sitemap: path.join(__dirname, './public/sitemap.xml'), // 自己站点的 sitemap 文件地址
  cache: true, // 是否启用缓存，启用缓存会将已经初始化的数据写入配置的 gitalkCacheFile 文件，下一次直接通过缓存文件判断
  gitalkCacheFile: path.join(__dirname, './gitalk-init-cache.json'), // 用于保存 gitalk 已经初始化的 id 列表
  gitalkErrorFile: path.join(__dirname, './gitalk-init-error.json'), // 用于保存 gitalk 初始化报错的数据
};

const api = 'https://api.github.com/repos/' + config.username + '/' + config.repo + '/issues';

/**
* 读取 sitemap 文件
* 远程 sitemap 文件获取可参考 https://www.npmjs.com/package/sitemapper
*/
const sitemapXmlReader = (file) => {
  try {
    const data = fs.readFileSync(file, 'utf8');
    const sitemap = xmlParser(data);
    let ret = [];
    sitemap.root.children.forEach(function (url) {
      const loc = url.children.find(function (item) {
        return item.name === 'loc';
      });
      if (!loc) {
        return false;
      }
      const title = url.children.find(function (item) {
        return item.name === 'title';
      });
      const desc = url.children.find(function (item) {
        return item.name === 'desc';
      });
      const date = url.children.find(function (item) {
        return item.name === 'date';
      });
      ret.push({
        url: loc.content,
        title: title.content,
        desc: desc.content,
        date: date.content,
      });
    });
    return ret;
  } catch (e) {
    return [];
  }
};

// 获取 gitalk 使用的 id
const getGitalkId = ({
  url: u,
  date
}) => {
  const link = url.parse(u);
  // 链接不存在，不需要初始化
  if (!link || !link.pathname) {
    return false;
  }
  if (!date) {
    return false;
  }
  return md5(link.pathname);
};

/**
* 通过以请求判断是否已经初始化
* @param {string} gitalk 初始化的id
* @return {[boolean, boolean]} 第一个值表示是否出错，第二个值 false 表示没初始化， true 表示已经初始化
*/
const getIsInitByRequest = (id) => {
  const options = {
    headers: {
      'Authorization': 'token ' + config.token,
      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36',
      'Accept': 'application/json'
    },
    url: api + '?labels=' + id + ',Gitalk',
    method: 'GET'
  };
  return new Promise((resolve) => {
    request(options, function (err, response, body) {
      if (err) {
        return resolve([err, false]);
      }
      if (response.statusCode != 200) {
        return resolve([response, false]);
      }
      const res = JSON.parse(body);
      if (res.length > 0) {
        return resolve([false, true]);
      }
      return resolve([false, false]);
    });
  });
};

/**
* 通过缓存判断是否已经初始化
* @param {string} gitalk 初始化的id
* @return {boolean} false 表示没初始化， true 表示已经初始化
*/
const getIsInitByCache = (() => {
  // 判断缓存文件是否存在
  let gitalkCache = false;
  try {
    gitalkCache = require(config.gitalkCacheFile);
  } catch (e) {}
  return function (id) {
    if (!gitalkCache) {
      return false;
    }
    if (gitalkCache.find(({
        id: itemId
      }) => (itemId === id))) {
      return true;
    }
    return false;
  };
})();

// 根据缓存，判断链接是否已经初始化
// 第一个值表示是否出错，第二个值 false 表示没初始化， true 表示已经初始化
const idIsInit = async (id) => {
  if (!config.cache) {
    return await getIsInitByRequest(id);
  }
  // 如果通过缓存查询到的数据是未初始化，则再通过请求判断是否已经初始化，防止多次初始化
  if (getIsInitByCache(id) === false) {
    return await getIsInitByRequest(id);
  }
  return [false, true];
};

// 初始化
const gitalkInit = ({
  url,
  id,
  title,
  desc
}) => {
  //创建issue
  const reqBody = {
    'title': title,
    'labels': [id, 'Gitalk'],
    'body': url + '\r\n\r\n' + desc
  };

  const options = {
    headers: {
      'Authorization': 'token ' + config.token,
      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36',
      'Accept': 'application/json',
      'Content-Type': 'application/json;charset=UTF-8'
    },
    url: api,
    body: JSON.stringify(reqBody),
    method: 'POST'
  };
  return new Promise((resolve) => {
    request(options, function (err, response, body) {
      if (err) {
        return resolve([err, false]);
      }
      if (response.statusCode != 201) {
        return resolve([response, false]);
      }
      return resolve([false, true]);
    });
  });
};


/**
* 写入内容
* @param {string} fileName 文件名
* @param {string} content 内容
*/
const write = async (fileName, content, flag = 'w+') => {
  return new Promise((resolve) => {
    fs.open(fileName, flag, function (err, fd) {
      if (err) {
        resolve([err, false]);
        return;
      }
      fs.writeFile(fd, content, function (err) {
        if (err) {
          resolve([err, false]);
          return;
        }
        fs.close(fd, (err) => {
          if (err) {
            resolve([err, false]);
            return;
          }
        });
        resolve([false, true]);
      });
    });
  });
};

const init = async () => {
  const urls = sitemapXmlReader(config.sitemap);
  // 报错的数据
  const errorData = [];
  // 已经初始化的数据
  const initializedData = [];
  // 成功初始化数据
  const successData = [];
  for (const item of urls) {
    const {
      url,
      date,
      title,
      desc
    } = item;
    const id = getGitalkId({
      url,
      date
    });
    if (!id) {
      console.log(`id: 生成失败 [ ${id} ] `);
      errorData.push({
        ...item,
        info: 'id 生成失败',
      });
      continue;
    }
    const [err, res] = await idIsInit(id);
    if (err) {
      console.log(`Error: 查询评论异常 [ ${title} ] , 信息：`, err || '无');
      errorData.push({
        ...item,
        info: '查询评论异常',
      });
      continue;
    }
    if (res === true) {
      // console.log(`--- Gitalk 已经初始化 --- [ ${title} ] `);
      initializedData.push({
        id,
        url,
        title,
      });
      continue;
    }
    console.log(`Gitalk 初始化开始... [ ${title} ] `);
    const [e, r] = await gitalkInit({
      id,
      url,
      title,
      desc
    });
    if (e || !r) {
      console.log(`Error: Gitalk 初始化异常 [ ${title} ] , 信息：`, e || '无');
      errorData.push({
        ...item,
        info: '初始化异常',
      });
      continue;
    }
    successData.push({
      id,
      url,
      title,
    });
    console.log(`Gitalk 初始化成功! [ ${title} ] - ${id}`);
    continue;
  }

  console.log(''); // 空输出，用于换行
  console.log('--------- 运行结果 ---------');
  console.log(''); // 空输出，用于换行

  if (errorData.length !== 0) {
    console.log(`报错数据： ${errorData.length} 条。参考文件 ${config.gitalkErrorFile}。`);
    await write(config.gitalkErrorFile, JSON.stringify(errorData, null, 2));
  }

  console.log(`本次成功： ${successData.length} 条。`);

  // 写入缓存
  if (config.cache) {
    console.log(`写入缓存： ${(initializedData.length + successData.length)} 条，已初始化 ${initializedData.length} 条，本次成功： ${successData.length} 条。参考文件 ${config.gitalkCacheFile}。`);
    await write(config.gitalkCacheFile, JSON.stringify(initializedData.concat(successData), null, 2));
  } else {
    console.log(`已初始化： ${initializedData.length} 条。`);
  }
};

init();

修改scripts中的脚本，添加"talk": "node talk-auto-init.js"：

1
2
3
4
5
6

"scripts": {
  "start": "hexo clean && hexo g && hexo s",
  "publish": "hexo g && hexo s",
  "d": "npm run prod && hexo deploy && npm run talk",
  "talk": "node talk-auto-init.js"
},

测试

1

npm run talk

已经缓存过后的结果：

1
2
3
4
5
6
7
8
9
10

➜ npm run talk

> hexo-site@2.0.0 talk /Users/macos/Projects/hexo-blog
> node talk-auto-init.js


--------- 运行结果 ---------

本次成功： 0 条。
写入缓存： 73 条，已初始化 73 条，本次成功： 0 条。参考文件 ~/gitalk-init-cache.json。