Rime 输入法中的快捷键

今天在整理 Rime 插件使用的时候，想起来整理一下 Rime 输入法的快捷键。

在之前整理 Rime 基础配置的时候稍微带到一下。

通过配合这些快捷键可以在输入很长一段句子的时候提升体验。

ctrl+grave (grave) tab 键上面，1 左边的那个键用来切换 Rime 输入方案
shift+delete 删除选中的候选词，一般用来调整不希望在候选词前的词
ctrl+ n/p 上下翻页选择候选词
Ctrl+b/f 类似于左箭头，右箭头，可以快速调整输入，在输入很长一段后调整之前的输入时非常有效
Ctrl+a/e 贯标快速跳转到句首或者句末
Ctrl+d 删除光标后内容
Ctrl+h 回退，删除光标前内容
Ctrl+g 清空输入
Ctrl+k 删词，等效于 Shift + delete（macOS 上可以使用 ⌘+k）
-/+ 或者 tab 来翻页

更多的快捷键可以在 default.yaml 配置中看到。

key_binder:
  bindings:
    - {accept: "Control+p", send: Up, when: composing}
    - {accept: "Control+n", send: Down, when: composing}
    - {accept: "Control+b", send: Left, when: composing}
    - {accept: "Control+f", send: Right, when: composing}
    - {accept: "Control+a", send: Home, when: composing}
    - {accept: "Control+e", send: End, when: composing}
    - {accept: "Control+d", send: Delete, when: composing}
    - {accept: "Control+k", send: "Shift+Delete", when: composing}
    - {accept: "Control+h", send: BackSpace, when: composing}
    - {accept: "Control+g", send: Escape, when: composing}
    - {accept: "Control+bracketleft", send: Escape, when: composing}
    - {accept: "Alt+v", send: Page_Up, when: composing}
    - {accept: "Control+v", send: Page_Down, when: composing}
    - {accept: ISO_Left_Tab, send: Page_Up, when: composing}
    - {accept: "Shift+Tab", send: Page_Up, when: composing}
    - {accept: Tab, send: Page_Down, when: composing}
    - {accept: minus, send: Page_Up, when: has_menu}
    - {accept: equal, send: Page_Down, when: has_menu}
    - {accept: comma, send: Page_Up, when: paging}
    - {accept: period, send: Page_Down, when: has_menu}
    - {accept: "Control+Shift+1", select: .next, when: always}
    - {accept: "Control+Shift+2", toggle: ascii_mode, when: always}
    - {accept: "Control+Shift+3", toggle: full_shape, when: always}
    - {accept: "Control+Shift+4", toggle: simplification, when: always}
    - {accept: "Control+Shift+5", toggle: extended_charset, when: always}
    - {accept: "Control+Shift+exclam", select: .next, when: always}
    - {accept: "Control+Shift+at", toggle: ascii_mode, when: always}
    - {accept: "Control+Shift+numbersign", toggle: full_shape, when: always}
    - {accept: "Control+Shift+dollar", toggle: simplification, when: always}
    - {accept: "Control+Shift+percent", toggle: extended_charset, when: always}
    - {accept: "Shift+space", toggle: full_shape, when: always}
    - {accept: "Control+period", toggle: ascii_punct, when: always}

自定义快捷键

在上面的配置中可以看到 Rime 默认就定义了非常多的快捷键绑定，并且这些快捷键都可以通过配置改变。

这里做一个例子，比如平时用 Vim 较多，想要更换成更加舒服的 Vim 绑定，可以在 Rime 配置根目录中 vi default.custom.yaml 中配置：

# default.custom.yaml
patch:
	# 其他配置...
	key_binder:
		bindings:
      	- { when: has_menu, accept: "Control+k", send: Page_Up }
      	- { when: has_menu, accept: "Control+j", send: Page_Down }
      	- { when: has_menu, accept: "Control+h", send: Left }
      	- { when: has_menu, accept: "Control+l", send: Right }

这样就可以使用 Ctrl+j/k 来上下翻页，而使用 Ctrl+h/l 来左右切换候选词。不过我个人还是还是习惯默认设置的快捷键。

配置说明

在上面的例子中可以看到 bindings 配置中有三个配置选项。每一条 binding 下面可以包含：

accept，实际接受的按键
send，输出效果
toggle，切换开关
when，作用范围

toggle 的候选项有：

ascii_mode
ascii_punct
full_shape 全角字符
simplification 繁简
extended_charset

when 可以接受的选项有：

paging	翻页
has_menu	操作候选项用
composing	操作输入码用
always	全域

accept 和 send 可用字段除 A-Za-z0-9 外，还可以包含键盘上实际的所有按键：

BackSpace	退格
Tab	水平定位符
Linefeed	换行
Clear	清除
Return	回車
Pause	暫停
Sys_Req	印屏
Escape	退出
Delete	刪除
Home	原位
Left	左箭頭
Up	上箭頭
Right	右箭頭
Down	下箭頭
Prior、Page_Up	上翻
Next、Page_Down	下翻
End	末位
Begin	始位
Shift_L	左Shift
Shift_R	右Shift
Control_L	左Ctrl
Control_R	右Ctrl
Meta_L	左Meta
Meta_R	右Meta
Alt_L	左Alt
Alt_R	右Alt
Super_L	左Super
Super_R	右Super
Hyper_L	左Hyper
Hyper_R	右Hyper
Caps_Lock	大寫鎖
Shift_Lock	上檔鎖
Scroll_Lock	滾動鎖
Num_Lock	小鍵板鎖
Select	選定
Print	列印
Execute	執行
Insert	插入
Undo	還原
Redo	重做
Menu	菜單
Find	蒐尋
Cancel	取消
Help	幫助
Break	中斷
space
exclam	!
quotedbl	"
numbersign	#
dollar	$
percent	%
ampersand	&
apostrophe	'
parenleft	(
parenright	)
asterisk	*
plus	+
comma	,
minus	-
period	.
slash	/
colon	:
semicolon	;
less	<
equal	=
greater	>
question	?
at	@
bracketleft	[
backslash
bracketright	]
asciicircum	^
underscore	_
grave	`
braceleft	{
bar	|
braceright	}
asciitilde	~
KP_Space	小鍵板空格
KP_Tab	小鍵板水平定位符
KP_Enter	小鍵板回車
KP_Delete	小鍵板刪除
KP_Home	小鍵板原位
KP_Left	小鍵板左箭頭
KP_Up	小鍵板上箭頭
KP_Right	小鍵板右箭頭
KP_Down	小鍵板下箭頭
KP_Prior、KP_Page_Up	小鍵板上翻
KP_Next、KP_Page_Down	小鍵板下翻
KP_End	小鍵板末位
KP_Begin	小鍵板始位
KP_Insert	小鍵板插入
KP_Equal	小鍵板等於
KP_Multiply	小鍵板乘號
KP_Add	小鍵板加號
KP_Subtract	小鍵板減號
KP_Divide	小鍵板除號
KP_Decimal	小鍵板小數點
KP_0	小鍵板0
KP_1	小鍵板1
KP_2	小鍵板2
KP_3	小鍵板3
KP_4	小鍵板4
KP_5	小鍵板5
KP_6	小鍵板6
KP_7	小鍵板7
KP_8	小鍵板8
KP_9	小鍵板9

通过上面的组合就可以实现非常多自定义的功能，比如有人喜欢将 ; 绑定到第二个候选词：

{ when: has_menu, accept: ";", send: 2 }

这样当候选词出现在第二位时，直接按下 ; 就可以输入。

reference

Rime 输入法配置

2021-10-01 rime , shortcut , keybinding , input-method

用 Gatsby 写了一个券商推荐注册列表

放假在家，刚好刷 Twitter 的时候看到有人写了一个券商注册的页面，一个简单的列表，挂上了目前常用的美港股做新人推荐，顺便就看了一下源码，发现使用 [[Gatsby]] 和 [[TailwindCSS]] 写的，于是就抱着学习的态度，上手了一下 Gatsby，简单的了解了一下 Gatsby 也是一个静态网页生成器，用来 React 和 [[GraphQL]]。而 [[TailwindCSS]] 是一个 CSS 框架，通过简单的 class 就能实现不错的界面效果。

从了解一个新的技术，到上手的过程就不多说了，官网的新手教程非常详细。这里就想记录一下中间遇到的一些问题，以及解决的过程。以及结合之前看过的 [[费曼学习法]] 聊一聊学习的过程。

费曼学习法

首先先说一下什么叫做费曼学习法，如果用简单的话来说就是将复杂的知识简单化，用最通俗的语言去解释。

费曼学习法的具体内容很细致，但如果将学习划分几个步骤来的话，可以简化成这样几部：

确定学习目标
理解学习对象
以输出代替输入
回顾
简化学习内容，再吸收

套用我了解学习 Gatsby 的过程，首先我的目标非常明确，就是制作一个简单的页面可以展示列表。

理解学习对象，在我看来就是通过查看其官网，文档，以及简单的 Wiki 了解 Gatsby 是什么，可以做什么。我这里要了解的内容有两部分，一个便是静态网站生成器 Gatsby，另一个是 CSS 框架 [[TailwindCSS]]。

静态网站生成器和 CSS 框架两个概念都不是很陌生，类似的技术也都非常多，当前的这个博客就是 Ruby 下的 Jekyll 生成的静态页面，而这个博客用的就是 Bootstrap CSS 框架。所以使用类比就能大致的对其有一定的了解。

第三步，用输出代替输入，这就是实践的部分。当然也是个人认为最重要的一步，再以前我往往就是忽视了这一步。所以直接根据官网的教程，先实现一遍新手任务，然后根据我的需要，先从官网初始化了一个最基本的项目，然后在本地跑起来，引入 Tailwind CSS，然后尝试对页面进行修改，先构建了一个基本的样式，将图中的一个样式实现，研究如何获取数据，如何实现循环。

最后定下的方案就是通过 YAML 文件，将页面中需要显示的内容配置在其中，因为 Gatsby 通过插件的方式可以非常方便的引入不同类型的数据源，所以看一下插件的介绍。在实践中花了最多时间的就是将图片动态的显示出来，直接使用 StaticImage 只能将固定的图片显示出来。所以继续阅读官网的文档。以 image 为关键字把所有搜出来的结果都看了，还是一头雾水，并且昨天状态也不太好就直接先睡了。今天起来从原理上简单的了解了一下 Gatsby 的插件，然后逐渐就有了一个思路。

在 Gatsby 中有三类插件：

数据源插件，一般名字中会带 source，数据源插件负责从外部数据获取，然后将数据放在数据层中，方便应用通过 GraphQL 来获取使用
数据转化插件, 名字中带 transformer，转换特定的格式，比如将 markdown 文件内容转换为对象
功能插件，一般就叫做某某 plugin

我已经通过 gatsby-transformer-yaml 将 YAML 文件内容可以在界面中读取，剩下的就是将 YAML 配置中配置的文件路径在界面中展示出来，Gatsby 这一块做过一些 API 的调整，需要通过 GraphQL 查询出来之后再使用 GatsbyImage 来展示。

整个上面的过程完成之后就大致做了一个类似的列表页。

回到费曼学习法的第四步，回顾，这一步也是正是我当前正在做的事情。

第五步，简化学到的内容，如果让我现在再去回忆我学到了什么，我脑海里首先会蹦出几个关键字，不是 Gatsby，也不是 [[TailwindCSS]]，而是 React，GraphQL，基础的 CSS 长宽模型。我之前没有接触过 React，但是在使用的过程中大概的了解了其模块化的设计，并且界面和数据分离，通过 GraphQL 做数据绑定和交互整个这个过程就形成了 Gatsby 这个技术。而在使用 Tailwind CSS 的过程中最费我时间的就是调整页面中元素的位置。如果之前学习基础 CSS 的时候能够对 margin，padding 有更多的了解就好了。

什么是好的学习

在费曼学习法这本书中对学习的解释，让我对[[教育]]有了更加深刻的理解。上周末在吃饭的时候，朋友顺口聊起了什么是你认为的「好的教育」，在去探讨什么是「好的教育」之前，什么是学习，在过去的时间里，我常常认为记得比别人多，学的比人快就是好的学习。但学习，不是去比拼知识的储备，也不是去竞争学位的高低，而是思维方式的培养。学习不是为了记住什么，而是通过学习建立自己行之有效的思维方式，然后将知识应用到实际生活中去解决问题。那么回到我认为的「好的教育」，学习如果是主动发起的，那么往往会收获不错的结果。那么好的教育就是要让人激发出学习的兴趣。

在没有了解 Gatsby 之前我对静态网站的印象就停留在了 markdown 文件的渲染，但是我在了解的过程中发现 Gatsby 使用了一套不一样的实现思路，通过 GraphQL 的帮助，Gatsby 让 markdown 成为了其可以选择的一个数据源，只要做一层数据转换，那么其内容可以从任何的数据源中获取，比如从 WordPress 的数据库，从其他任何 CMS 的数据源。这样就使得 Gatsby 拥有了其他静态网站不一样的能力。

最后

代码在 https://github.com/einverne/broker 界面在 https://broker.einverne.info。

2021-10-01 broker , invest , static-site , gatsby , react , graphql

Traefik 入门使用

Traefik 是什么

Traefik （音同 traffic），是一个 Cloud Native 的 HTTP reverse proxy（反向代理）和 load balancer（负载均衡），反向代理服务器就是可以拦截流量并根据规则把流量导到特定的服务上。

在没有 [[Traefik]] 之前，如果在 orchestrator （比如 Swarm 或 Kubernetes）或 service registry（比如 etcd 或 consul）下开发了一系列的微服务，并要让用户可以访问这些服务，你可能需要手动配置一个反向代理。传统的反向代理服务器（比如 Nginx）需要为每一个子域名到微服务服务进行配置。在一个每一天需要进行很多次增加，移除，升级，扩容的微服务环境下，传统的配置方式（基于配置文件）会变得非常繁琐。

Traefik 可以很好的和现存的基础架构结合到一起，包括 Docker, Swarm mode, Kubernetes, Marathon, Consul, Etcd, Rancher, Amazon ECS 等等

Traefik 会监听 service registry/orchestrator API 并且立即产生一个路由规则，这样微服务可以直接连接到外部的世界，不再需要额外的干预。

Kubernetes 负责把 Pod 容器自动分配到 Node 节点处理。

功能：

持续的更新配置，无需重启 Traefik 即可更新配置
自动的服务发现与负载均衡
支持多样的负载均衡算法
完美支持 docker 基于 label 配置
借助 Let’s Encrypt 实现 HTTPS
Circuit breakers, retry
通过网页界面查看路由
Websocket, HTTP/2, GRPC ready
metrics 的支持，支持对 prometheus 和 k8s 集成
提供监控指标（Rest, Prometheus, Datadog, Statsd, InfluxDB）
访问日志（JSON, CLF）
提供 Rest API
单一的二进制文件（Go 编写），提供官方的 docker 镜像
Dashboard 界面

概念

在进一步学习 Traefik 之前有几个在 Traefik 中的概念需要提前了解一下。

Providers 是 Traefik 的服务提供方，可以是 orchestrators 也可以是容器引擎，cloud prividers 或者 key-values 存储。Traefik 需要依赖这些服务的 APIs 来自动发现服务和路由，然后动态的更新路由。
Entrypoints 监听传入的流量，接口请求的端口
Routers 分析请求，将请求连接到对应的服务
Services，将请求转发给应用（load balancing），配置如何将流量最终传入这些 Services
Middlewares ，中间件，用来修改请求或根据请求来做判断（authentication，rate limiting，headers），Middlewares 附加在路由上，在请求发送到服务之前（或者在服务响应发送到客户端之前）对请求进行调整

Traefik 是如何发现服务的？

Traefik 能够通过 cluster API 自动发现服务，在 Traefik 的配置中，被称为 provider。比如 provider 配置了 Docker，那么 Traefik 会自动根据 Docker 提供的 API 来获取发现服务，并自动根据配置更新路由策略。

在 Docker 环境下使用 docker-compose 安装使用

为了了解最基本的使用，最好的方法就是实践自己启动一下。

version: '3'

services:
  traefik:
    container_name: traefik
    image: traefik:latest
    restart: always
    command: --api.insecure=true --providers.docker
    ports:
      - "80:80"
      - "443:443"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./ssl/:/data/ssl/:ro
      - ./traefik.yml:/etc/traefik.yml:ro
      - ./config/:/etc/traefik/config/:ro
      
# 先创建外部网卡
# docker network create traefik
networks:
  traefik:
    external: true

启动之后可以访问

http://localhost:8080/api/rawdata 检查 Traefik 暴露的 API rawdata

上面的方式开启了 Traefik 的 Dashboard，可以直接访问 8080 端口。

然后使用 whoami 镜像做一下验证，该镜像会将请求的 header 信息输出在请求结果中。

version: '3'

services:
  whoami:
    # A container that exposes an API to show its IP address
    image: traefik/whoami
    labels:
      - "traefik.enable=true"
      # 设置Host 为 whoami.docker.localhost 进行域名访问
      - "traefik.http.routers.whoami.rule=Host(`whoami.docker.localhost`)"

# 使用已存在的 traefik 的 network
networks:
  default:
    external:
      name: traefik

当 whoami 的服务启动之后 Traefik 会自动根据 label 的配置，然后将 whoami.docker.localhost 的请求自动转发到 whoami 这个服务中。

然后修改一下本地的 /etc/hosts 文件，增加

127.0.0.1 whoami.docker.localhost

然后用浏览器访问 http://whoami.docker.localhost 就可以看到 whoami 这个服务的返回。

或者直接使用 curl 请求：

❯ curl http://whoami.docker.localhost/
Hostname: 20f1d26a6db0
IP: 127.0.0.1
IP: 172.30.0.3
RemoteAddr: 172.30.0.2:49750
GET / HTTP/1.1
Host: whoami.docker.localhost
User-Agent: curl/7.58.0
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 172.30.0.1
X-Forwarded-Host: whoami.docker.localhost
X-Forwarded-Port: 80
X-Forwarded-Proto: http
X-Forwarded-Server: ab231307712a
X-Real-Ip: 172.30.0.1

Configuration

[[traefik-configuration]] 有两种配置方式：

完全动态的配置 (dynamic configuration)
静态初始配置（static configuration)

自动重定向到 https

所有到 80 端口的流量都会被重定向到 443 端口。

--entrypoints.web.address=:80
--entrypoints.web.http.redirections.entryPoint.to=websecure
--entrypoints.web.http.redirections.entryPoint.scheme=https
--entrypoints.web.http.redirections.entrypoint.permanent=true
--entrypoints.websecure.address=:443

部署举例

[[Traefik 部署 n8n]]
[[Traefik 部署 miniflux]]

reference

2021-09-28 traefik , nginx , cloud-native , reverse-proxy

在两个 DataGrip 之间同步数据库配置以及一些使用笔记

DataGrip 是 JetBrains 出品的一款数据库管理工具。

同步

从 2021.1 版本开始，可以在 Data Source 上按下 Ctrl/Cmd+C 复制，然后在其他的 IDE 中使用 Ctrl/Cmd+V 来粘贴。

粘贴板会包含 Data Source 的 XML 配置。

但使用 Cmd+C 的同步方式，粘贴板并不会粘贴密码内容，所以粘贴之后也还需要输入数据库密码进行验证。

同步表结构

虽然这种情况我自己很少操作，但是看了一下还是有很多有这样的需求，这里就记录一下，比如有两个环境，本地开发环境和线上环境，如果本地已经完成表结构的变更，想要将这个表结构的更新同步到线上的数据库中，可以直接利用 DataGrip 的同步表结构。

A1iMMEc1_1

当然我个人推荐的做法是通过将 SQL 放入版本控制做好 Migration，或者使用自动化的 SQL 版本，比如 Python 下的 [[Alembic]] 来管理数据库表结构的版本，实现可以自动升级，降级等。

2021-09-27 jetbrains , datagrip , mysql , postgresql , sql , redis

espanso：Rust 编写的跨平台开源文本扩展工具

今天在 review tldr 提交的新命令的时候发现了一个新的工具 espanso，查看其官网发现是一个文本扩展的工具（[[TextExpander]]）。在之前 macOS 上短暂的体验过 [[Keyboard Maestro]] 但因为其是 macOS 独占，所以之后再回到 Ubuntu 下的时候就渐渐不用了，并且其授权还挺贵的。然后就一直使用 RIME 配置自定义的短语来作为短语的快捷输入，比如输入 date 的时候自动在候选词中添加日期。但这样的问题便在于每一次更改 RIME 的配置文件都需要经历 RIME 部署这样一个漫长的过程。并且可扩展性也不强。于是想来体验一下 espanso 。

[[Espanso]] 是一个使用 Rust 实现的跨屏平台的 Text Expander，可以在任何编辑器中扩展短语。可以完美代替 [[Keyboard Maestro]] 的 Text Expand 功能。

官网地址：

https://espanso.org

特性：

扩展功能强，可以通过 package 扩展
响应速度快，我下载体验后没有任何卡顿
支持 form 和 regex
文档完善
完成度高
定义光标位置
支持剪贴板
可以自动填充图像
支持扩展外部脚本（任何语言）
用于特定程序匹配

安装

在 macOS 上：

brew tap federico-terzi/espanso
brew install espanso
espanso --version

然后使用 espanso register 启用。

在 Linux 上：

sudo snap install espanso --classic

安装完成后执行：

espanso start

启动后台任务。这样在任何编辑器中输入 :espanso 会自动转变成 Hi there!。

更多安装方式可以参考官网。

使用

其官网有一个非常生动形象的 GIF，当输入:

:greet 自动变成 hello world
:date 自动产生日期
:llo 变成一串 Emoji
:ip 变成真实的 IP 地址

执行 espanso edit 会自动使用默认的编辑器创建一个默认的配置文件到 ~/.config/espanso/default.yml 文件：

matches:
  # Simple text replacement
  - trigger: ":espanso"
    replace: "Hi there!"

  # Dates
  - trigger: ":date"
    replace: ""
    vars:
      - name: mydate
        type: date
        params:
          format: "%m/%d/%Y"

  # Shell commands
  - trigger: ":shell"
    replace: ""
    vars:
      - name: output
        type: shell
        params:
          cmd: "echo Hello from your shell"

Configuration

espanso 基于文本的配置文件对软件的行为进行设定，在不同操作系统上的路径：

Linux: ~/.config/espanso
macOS: /Users/einverne/Library/Preferences/espanso
Windows: C:\Users\user\AppData\Roaming\espanso

可以通过 espanso path 来快速获知路径。

default.yml 文件是 espanso 的主要配置文件，使用 YAML 语法。

更加详细的配置文件可以参考官方文档。

自定义光标位置

在 espanso 的配置 replace 中可以使用 $|$ 作为占位符，表示光标。

比如想要输入 :div 的时候自动展开成为 <div></div> 然后将光标停留到中间，就可以使用：

  - trigger: ":div"
    replace: "<div>$|$</div>"

Package

Espanso 更加强大的地方在与其扩展性，通过安装其他包可以将 espanso 的能力扩展。比如从 espanso hub 安装 Basic Emojis :

espanso install basic-emojis

然后重启服务：

espanso restart

然后输入 :ok 就可看到文本被替换成了 Emoji。

![[Pasted image 20211013182143.png]]

更多的 package 可以看 espansohub。

快捷键

一些非常有用的快捷键。

Toggle Key

可以通过连续按两次 ALT(macOS 下为 Option) 按键来临时禁用 espanso。可以看到通知 Espanso disabled。再按两次可以开启。可以通过配置文件修改 Toggle Key

Backspace Undo

有些时候可能无意识中触发了 expansion，但又不想要这个结果，那么可以按一下 BACKSPACE 撤销这一次修改。

同步配置文件

可以使用软链接的方式将配置文件放在同步文件夹，或 git 仓库中保存管理。

Linux 下

ln -s "/home/user/Dropbox/espanso" "/home/user/.config/espanso"

macOS 下，见脚本。

我个人直接将配方放到 dotfiles 中管理。

配置

https://www.webfx.com/tools/emoji-cheat-sheet/

reference

[[Rust 开源项目]]

2021-09-17 linux , macos , keyboard , text-expander

简单高效跨平台的备份程序 Restic

Restic 是一款简单易用、快速、高效、安全，并且跨平台的开源备份程序。Restic 使用 Go 语言实现。集成了 rclone 可以轻松的备份到各类云端存储。

官网：https://restic.net/

支持的存储类型：

本地磁盘，SFTP
Amazon S3，minIO，[[Backblaze B2 Cloud Storage]]，OpenStack Swift，Google Cloud Storage 等等
通过 rclone 挂载的存储，比如 Google Drive，OneDrive 等

Restic 设计原则

Restic 是一个数据备份程序，其设计遵循以下原则：

简单：备份应该是一个顺畅、无感知的过程。Restic 易于配置和使用，这样就可以在数据丢失的情况下直接恢复历史数据。同样，恢复数据的过程也不应该很复杂。
快速：用 Restic 备份数据应该只受网络或硬盘带宽的限制，这样就可以每天备份文件。如果备份需要花费太多时间，就没有人会进行备份。恢复备份也应该很快速。
可验证：比备份更重要的是恢复，因此 Restic 可以轻松验证备份的数据是否可以恢复。
安全：Restic 使用加密技术来保证数据的机密性和完整性。假设存储备份数据的位置不是受信任的环境（例如，系统管理员等其他人能够访问您的备份的共享空间）。 Restic 可以保护您的数据免受此类攻击者的侵害。
高效：随着数据的增长，额外的快照应该只占用实际增量的存储。重要的是，在将重复数据实际写入存储后端之前会对其进行去重，以节省宝贵的备份空间。

概念

Repository

Repository 称为存储仓库，备份期间产生的所有数据都以结构化形式发送并存储在存储库中，例如在具有多个子目录的文件系统层次结构中。

存储库实现必须能够完成许多操作，例如列出内容。v0.12.0 中已支持的存储服务包括：aws s3，minio server，Wasabi， Aliyun OSS， OpenStack Swift，Backlbaze B2，Azure Blob Storage，Google Cloud Storage，rclone

Blob

Blob 将多个数据字节与识别信息（如数据的 SHA-256 哈希及其长度）,加密的数据块及元数据，其中元数据包括长度，SHA-256 哈希信息。数据块可以存放文件数据（data），也可以存放目录结构数据（tree）。Blob 的大小在 512KiB 到 8MiB 之间，因此小于 512KB 的文件不会被拆分。Restic 的实现目标是让 Blob 平均大小为 1MiB。

Pack

Pack 是一个包，结合了一个或多个 Blob，例如在单个文件中。Restic 中的单个数据文件，包括一个或多个 Blob，一旦创建不再修改。

一般只创建不删除，仅 prune 操作会删除不再被引用的数据。

Snapshot

Snapshot 快照代表在某个时间点已备份的文件或目录的状态。这里的状态是指内容和元数据，如文件或目录及其内容的名称和修改时间。

Storage ID

Storage ID：Pack 文件的 SHA256 哈希值，通过这个 ID 可以在仓库中加载需要的数据文件。Restic 将这个 ID 作为 Pack 的文件名，也就是文件的 SHA256 哈希值。Pack 文件名即哈希值的设计也可以方便的检验数据文件是否被改动过。

Install

Debian/Ubuntu:

apt-get install restic

macOS:

brew install restic

通过二进制：

wget https://github.com/restic/restic/releases/download/v0.9.5/restic_0.9.5_linux_amd64.bz2
bzip2 -d restic*.bz2 && rm -rf restic*.bz2
chmod +x restic*
mv restic* /usr/local/bin/restic
restic version

升级可以通过：

restic self-update

Usage

初始化本地备份：

restic init --repo /path/to/backup_folder

配置 SFTP 存储，配置 SSH 免密码登录：

restic -r sftp:root@192.168.2.100:/path/to/backup_folder init

如果服务器的 SSH 端口不是 22，则需要配置 ssh 配置，编辑 ~/.ssh/config 然后配置：

Host 192.168.2.100
  User root
  Port 222

将目录 /var/www 备份到服务器的 /path/to/backup_folder

restic -r sftp:192.168.2.100:/path/to/backup_folder --verbose backup /var/www

查看备份快照：

restic -r sftp:192.168.2.100:/path/to/backup_folder snapshots

恢复备份：

restic -r sftp:192.168.2.100:/path/to/backup_folder restore latest --target /var/www

这里的 latest 可以替换为任意一次的备份 ID。

删除备份：

restic -r sftp:root@192.168.2.100:/path/to/backup_folder forget abc3123

上面的命令只是将快照清除了，但快照中包含的文件还在存储仓库中，可以使用 prune 命令来清理未被引用的数据：

restic -r sftp:root@192.168.2.100:/path/to/backup_folder prune

结合 cron 来定时备份

每隔 30 分钟备份一次

30 * * * * /usr/local/bin/restic -r sftp:root@192.168.2.100:/path/to/backup_folder backup --password-file /home/einverne/restic/resticpasswd -q /var/www; /usr/local/bin/restic forget -q --prune --keep-hourly 24 --keep-daily 7

Restic 和 rclone 的区别

两个工具的设计目的是不一样的，Restic 更偏向备份工具，所以设计了很多备份、恢复、查看验证历史版本等等特性。而 Rclone 则更偏向于将网络硬盘挂载到机器中实现与云端存储的双向同步。二者各有所长。

Rclone 面向文件，保证两端文件一致，而 Restic 则是会加密文件再传输，每一次增量备份
Rclone 不会记录文件版本，Restic 每一次备份都会产生新版本

2021-09-12 restic , backup , backup-tool , tools , google-drive , go-lang , duplicacy , linux , syncthing

rTorrent 和 ruTorrent 中自动下载 RSS Feed

自从在 QNAP 上遇到 ruTorrent 之后就发现这是我用过的最好用的 BitTorrent 客户端了，rTorrent 结合 ruTorrent 界面

可以参考我的 docker-compose.yml 进行安装。然后照之前的文章启用 MaterialDesign，界面就非常漂亮。

RSS

首先 RSS 就不用多说了，在互联网早期就存在的一个分享格式，可以用于内容的聚合，虽然 Google Reader 关闭多年，但我个人依然还在重度的使用，从 InoReader 到自建 Tiny Tiny RSS 然后最终心属最简洁的 miniflux 可以说过去的 10 年里面一直都在使用 RSS。

这也使得在 Private Tracker 中使用 RSS 变得非常的容易，大部分的站点都是提供个人的 RSS feed 流的，我使用的 AvistaZ, PrivateHD，都是可以通过关键字订阅来生成自定义的 Feed 流的。

那就以 wishlist feed 流做一个例子，到对应的网站管理后台获取个人的 wishlist RSS feed, 一般是一个链接，当中包含了该 Feed 流的内容，比如说我的 Wishlist 就包含了我在网站中收藏的内容，这样只要我在浏览网站的时候将影片添加到 Wishlist，那么 Feed 中会自动添加该影片。

一般在界面中找这样的图标即可。

添加 RSS 链接到 ruTorrent

右击 ruTorrent 中的 Feeds 板块：

然后点击添加 RSS Feed，输入框中填入 Feed URL，以及 Custom Alias。

![[rutorrent-add-rss-feed-20210910211430.png]]

那新添加的 Feed 会自动出现在 Feeds 板块。在 Feed 板块中可以点击查看到 Feed 中的内容。但是这个时候 Feed 中的内容不会自动下载。如果需要配置自动下载需要使用下面的 RSS Manager（或者也被称为 Download Manager）。

配置 RSS Manager

然后右击 Feeds，打开 RSS Manager

这个界面中有一些内容需要配置，可以新建一个 Filter，点击左边的 ADD

右边的配置分别是：

Filter, 过滤器，可以使用正则表达式来过滤 Feed 中需要下载的内容，使用 /^/ 就表示下载所有。
Exclude，排除，包含那些关键字的内容不会下载，也可以使用正则。
Check title field，上面配置的正则表达式，是否检查标题
Check description field，检查描述
Check link field，检查链接
RSS，选项选择刚刚添加的 RSS URL
Directory，下载目录
Label，自动添加设置的 Label
Min interval，最小间隔
RatioGroup, 分享率设置
Channel，通道

点击保存，过一会儿就能看到 RSS 中的种子自动开始下载了。

不过这里需要特别注意，千万不要把一个全站的 RSS Feed 添加到自动下载，并配置下载全部，除非你知道这样做的意义。

另外如果要更加详细的设置 RSS 的刷新频率，则需要修改 rTorrent 的配置，如果有需要再更新吧。

另外如果使用的是类似于 Transmission 这样的客户端，并没有自带 RSS 管理，那也可以使用 Flexget 来间接实现 RSS 自动下载。配合 crontab，也可以实现相同的效果。

2021-09-10 rtorrent , rutorrent , linux , docker , rss , feed , private-tracker , torrent , bt

Kubernetes 学习笔记

Kubernetes (简称 k8s)是 Google 基于其内部容器调度平台 Borg 的经验开发的一个开源的容器编排和管理平台。2014 年开源，并作为 CNCF（云原生计算基金会）的核心发起项目。旨在简化容器化应用的部署、扩展和管理。它提供了一种便捷的方式来组织、调度和管理容器化应用程序，并能够自动化地处理应用程序在集群中的部署、扩展、故障恢复和负载均衡等任务。

设计的目的是在主机集群之间提供一个能够自动部署、扩展、应用容器的可运营的平台。Kubernetes 通常结合 docker 容器一起工作。

Kubernetes 使用了一种称为 Pods 的抽象概念来组织应用程序的容器。Pod 是一个或多个相关容器的组合，它们共享同一个网络命名空间、存储卷以及其他资源。这样，它们可以共享网络配置、文件系统和其他依赖关系，从而更好地协同工作。

Kubernetes 还提供了一种称为 Replication Controller 的机制，用于自动扩展和管理 Pod 实例。Replication Controller 可以根据设置的规则自动复制和删除 Pod 实例，以适应负载变化，并确保应用程序始终处于所需的状态。

此外，Kubernetes 还提供了一种称为 Service 的机制，用于将后端 Pod 实例暴露给外部访问。Service 可以为后端 Pod 实例提供负载均衡、服务发现和稳定访问地址等功能。

Kubernetes 还支持水平扩展、滚动更新、故障恢复等功能，使得应用程序的部署和管理变得更加简单和可靠。它还提供了丰富的 API 和命令行工具，以便管理员和开发者可以方便地管理和监控集群中的应用程序。

功能：

自动化容器部署、复制
随时扩展或收缩容器规模
组织容器成组，提供容器间的负载均衡
更新和回滚容器版本

Terminology

API Server：对外提供 RESTful 接口，系统管理指令的统一入口，对资源的操作都要交给 API Server 再提交给 etcd
schedule：调度 pod 到 Node
controller manager: 每一个资源对应一个控制器
etcd: 高可用的 key-value 存储，k8s 用来存储各个资源的状态

Master

Kubernetes 中的 Master 节点指的是集群控制节点，负责整个集群管理和控制。

Master 节点上运行着关键进程：

Kubernetes API Server(kube-apiserver)，提供 HTTP Rest 接口，所有资源的增删改查操作入口
Kubernetes Controller Manager（kube-controller-manager），所有资源对象的自动化控制中心
Kubernetes Scheduler（kube-scheduler),负责资源调度（Pod 调度）的进程

Node

Kubernetes 集群中除去 Master 之外的节点被叫做 Node 节点（Agent），工作负载节点，执行 Master 分配的工作。当 Node 节点宕机时，工作负载会自动转移到其他节点。

Node 节点运行的关键进程：

kubelet，负责 Pod 对应容器的创建、启动、停止等
kube-proxy, 实现 Kubernetes Service 的通信和负载均衡
Docker Engine（docker），Docker 引擎，负责本机容器创建和管理

可以使用如下命令查看集群中 Node：

kubectl get nodes

查看具体信息：

kubectl describe node kubernetes-minion1

Pods

k8s 最小调度单元，Pod 中运行业务相关的容器

Kubernetes 中最小的部署单元
包含一个或多个容器，可以被一起编排（schedule）
每一个 pod 都有一个唯一的 IP 地址
Pod 中的每一个容器可以通过 localhost 相互通信

Label

Label 是 key=value 键值对，附加到资源对象上，Node，Pod，Service，RC 等等。资源对象可以定义任意数量 Label，同一个 Label 也可以被添加到任意数量的资源对象上。

Replication Controller

Replication Controller（后简称 RC），定义了场景，声明某种 Pod 的副本数量在任意时刻都符合预期值。

定义包括几部分：

Pod 期待的副本数（replicas）
筛选目标 Pod 的 Label Selector
Pod 副本数量小于预期数量的时候，用于创建新 Pod 的模板（template）

Service

Service 就是「微服务」

Service 定义服务的访问入口
Service 与后端 Pod 副本集群之间通过 Label Selector 实现无缝对接
服务之间通过 TCP/IP 通信，形成灵活的弹性网络

apiVersion: v1
kind: Service
metadata:
  name: tomcat-service
spec:
  ports:
  - port: 8080
  selector:
    tier: frontend

定义了名为 tomcat-service 的 Service
端口 8080
Label 是 tier=frontend 的 Pod 实例都属于它

然后创建：

kubectl create -f tomcat-server.yaml

Namespace

Namespace 命名空间，用于实现多租户的资源隔离。

kubectl get namespace

在 Kubernetes 中，所有对象都使用 manifest（yaml 或 json）来定义，比如一个简单的 nginx 服务可以定义为 nginx.yaml，它包含一个镜像为 Nginx 的容器：

apiVersion: v1
kind: Pod
metadata:
  name: nginx
  labels:
    app: nginx
spec:
  containers:
  - name: nginx
    image: nginx
    ports:
    - containerPort: 80

2021-09-02 kubernetes , k8s , k3s , docker , container , cncf , google , borg , deployment

Docker Compose 中使用环境变量

通常在使用 Docker compose 的时候会设置很多的环境变量来控制容器的使用。

很多情况下我们会直接写到 docker-compose.yml 文件中类似于下面 environment 中的：

version: "3"
services:
  flarum:
    image: mondedie/flarum:stable
    container_name: flarum
    volumes:
      - ./flarum/extensions:/flarum/app/extensions
      - ./flarum/assets:/flarum/app/public/assets
      - ./flarum/storage/logs:/flarum/app/storage/logs
      - ./flarum/nginx:/etc/nginx/flarum
    ports:
      - 8888:8888
    environment:
      - UID=1000
      - GID=1000
      - DEBUG=false
      - FORUM_URL=https://forum.domain.tld
      - UPLOAD_MAX_SIZE=20M
      - DB_HOST=
      - DB_PORT=3306
      - DB_USER=
      - DB_PASS=123456
      - DB_NAME=

同样也可以使用 .env 文件来设定。Compose 会自动寻找 compose 文件同级目录的 .env 文件，并自动使用 .env 文件中的环境变量值覆盖 shell environment 中的内容。

Docker 使用环境变量

配置可以包含 environment variables，Compose 会使用 Shell 的环境变量值作为这些配置值。

假设 Shell 中配置了 POSTGRES_VERSION=9.3，那么如果有配置：

  db:
    image: "postgres:${POSTGRES_VERSION}"

当执行 docker-compose up 的时候，会自动将环境变量的值替换。上面的例子中就会自动使用 9.3 版本的配置。

如果环境变量没有配置，那么 Compose 会用一个空字符串替换。

如果要配置默认的环境变量，可以使用一个 .env 文件，Compose 会自动寻找项目目录下的该文件（和 docker-compose.yml 文件同级目录），Shell 环境变量中的值会覆盖 .env 文件中的。

$VARIABLE 和 ${VARIABLE} 两种语法都支持。

${VARIABLE:-default} 如果 VARIABLE 没有设置或是空，那么结果是 default
${VARIABLE-default} 只有当 VARIABLE 没有设置的时候才为 default

同样的，可以使用如下的语法强制要求用户设置：

${VARIABLE:?err} 如果 VARIABLE 没有设置，或者为空，那么会抛出移除信息 err
${VARIABLE?err} 如果 VARIABLE 没有设置，会抛出 err

使用 `--env-file` 选项

在命令行中指定 --env-file 路径。

docker-compose --env-file ./config/.env.dev up

和上一行命令等价的是，也可以使用 env_file 选项来将 env 文件配置到 docker-compose.yml 文件中：

web:
  env_file:
    - web-variable.env

环境变量优先级

上面提到了多种环境变量使用的方式，Compose 在选择环境变量时按照如下的优先级：

docker-compose.yml 文件中的 environment 设置
Shell 中指定的环境变量
环境文件 .env
Dockerfile
Variable is not defined

也就是说 compose 文件中定义的 environment 优先级是最高的。

reference

2021-08-29 docker , dockerfile , environment-variable , shell , linux

« Previous
1
2
3
4
5
...
35
...
137
Next »

Tweets by einverne

自定义快捷键

配置说明

reference

费曼学习法

什么是好的学习

最后

librime-lua

安装 librime-octagram 插件

BlindingDark/rime-lua-select-character

总结

Traefik 是什么

概念

Traefik 是如何发现服务的？

在 Docker 环境下使用 docker-compose 安装使用

Configuration

自动重定向到 https

部署举例

reference

同步

同步表结构

安装

使用

Configuration

自定义光标位置

Package

快捷键

Toggle Key

Backspace Undo

同步配置文件

配置

reference

Restic 设计原则

概念

Repository

Blob

Pack

Snapshot

Storage ID

Install

Usage

结合 cron 来定时备份

Restic 和 rclone 的区别

RSS

添加 RSS 链接到 ruTorrent

配置 RSS Manager

Terminology

Master

Node

Pods

Label

Replication Controller

Service

Namespace

Docker 使用环境变量

使用 --env-file 选项

环境变量优先级

reference

电子书

本站提供服务

文章分类

最近文章

使用 `--env-file` 选项