code-server + gitlab + markdown

一直是笔记软件的重度用户，但是做的好的云同步软件通常要收费，要么就是有大小的限制。
研究了在自己的服务器上搭建一套笔记软件。
介绍一下我的需求。

1. markdown语法 记录笔记，支持自动粘贴图片，截图等等
2. 多端访问，pc mac android ios pad，数据同步及时，手机端查看方便。
3. 数据方便备份，整理，最好是自己存储在服务器上。
4. 由于笔记很多，需要快速的检索功能。 拆分标签展示

使用之前的软件虽然也能满足部分需求，但是在自由度上还是有不方便的地方。
比如joplin 虽然多端同步和移动端支持做的非常好，但是界面真的丑...

现在使用code-server当替代方案，感觉除了移动端的支持弱一些，其他方面简直完美

code-server 就是vscode在云端运行，可以在浏览器使用vscode，试用后发现体验和本地运行基本没啥太大差距。

因此除了这个方案可以满足我上述的需求外，还能额外在 记录笔记的时候运行代码，甚至有命令行直接操作服务器。

因为这个优点，我把所有的项目代码用submodule的方式引入笔记目录中，基本实现了一个网页操作所有项目。

此外，自己搭建的方案费用可以便宜好多，腾讯云最垃圾的服务器一个月也才一二十。

现在介绍一下搭建步骤

安装code-server

首先你得有台服务器...
然后执行code-server安装命令
curl -fsSL https://code-server.dev/install.sh | sh

安装完成后 修改vscode配置
vim ~/.config/code-server/config.yaml
配置如下：
bind-addr: 0.0.0.0:88 #绑定端口
auth: password
password: xxxxxx
cert: xxxxxx/xx/xbundle.crt
cert-key: xxx/xxx/xxx.key

值得注意，cert 和cert-key是服务器的ssl证书
必须配置，不然后续无法使用https的方式访问vscode，导致无法预览图片 markdown文档

vscode配置

中文

先从扩展中搜索 chinese

image.png

安装之后
ctrl+shift +p 打开快捷命令栏输入 >Configure Display Language

选择简体中文即可

[图片上传中...(image (1).png-83faff-1693793004827-0)]

粘贴图片

记录笔记时候很多情况都会需要截图，如果直接在md文件中用快捷键粘，图片文件会直接粘贴在当前路径下，导致目录混乱

这里可以通过markdown.copy调整，在设置中搜索markdown.copy

image (1).png

通过配置项，将图片的粘贴位置指定到某个绝对路径、

image (2).png

比如我这样就是将md文件粘贴路径 固定到项目/data/img/md下。并且会在md文件夹下创建图片在笔记根目录下对应的文件夹。

可视化扩展

使用code-server的另外一个优点就是对于markdown语法及其可视化展示的支持非常好。
安装了 Markdown Preview Enhanced 之后可以支持 流程图，数学公式，思维导图等等可视化。

具体可以查看markdown preview enhanced官网

安装gitlab

gitlab 是自己搭建的git，主要目的是为了让笔记有版本控制。
当然我使用的目的是为了方便在笔记中随时加入代码片段并且记录版本。

由于gitlab占用内存极高，关闭了大多数配置后，服务器占用内存在2g以内，精简版本的docker-compose 配置如下：

version: "3"
services:
  gitlab:
    restart: always
    image: gitlab/gitlab-ce:14.0.5-ce.0
    container_name: gitlab
    hostname: xxxxx
    ports:
      - "99:80"
    volumes:
      - /root/static/gitlab/config:/etc/gitlab
      - /root/static/gitlab/data:/var/opt/gitlab
    environment:
      TZ: Asia/Shanghai
      GITLAB_OMNIBUS_CONFIG: |
        gitlab_rails['time_zone'] = 'Asia/Shanghai'

        # 关闭电子邮件相关功能
        gitlab_rails['smtp_enable'] = false
        gitlab_rails['gitlab_email_enabled'] = false
        gitlab_rails['incoming_email_enabled'] = false

        # Terraform
        gitlab_rails['terraform_state_enabled'] = false

        # Usage Statistics
        gitlab_rails['usage_ping_enabled'] = false
        gitlab_rails['sentry_enabled'] = false
        grafana['reporting_enabled'] = false

        # 关闭容器仓库功能
        gitlab_rails['gitlab_default_projects_features_container_registry'] = false
        gitlab_rails['registry_enabled'] = false
        registry['enable'] = false
        registry_nginx['enable'] = false

        # 包仓库
        gitlab_rails['packages_enabled'] = false
        gitlab_rails['dependency_proxy_enabled'] = false

        # GitLab KAS
        gitlab_kas['enable'] = false
        gitlab_rails['gitlab_kas_enabled'] = false

        # Mattermost
        mattermost['enable'] = false
        mattermost_nginx['enable'] = false

        # Kerberos
        gitlab_rails['kerberos_enabled'] = false
        sentinel['enable'] = false

        # GitLab Pages
        gitlab_pages['enable'] = false
        pages_nginx['enable'] = false

        # 禁用 PUMA 集群模式
        puma['worker_processes'] = 0
        puma['min_threads'] = 1
        puma['max_threads'] = 2
        

        # 降低后台守护进程并发数
        sidekiq['max_concurrency'] = 5

        gitlab_ci['gitlab_ci_all_broken_builds'] = false
        gitlab_ci['gitlab_ci_add_pusher'] = false

        # 关闭监控
        prometheus_monitoring['enable'] = false
        alertmanager['enable'] = false
        node_exporter['enable'] = false
        redis_exporter['enable'] = false
        postgres_exporter['enable'] = false
        pgbouncer_exporter['enable'] = false
        gitlab_exporter['enable'] = false
        grafana['enable'] = false
        sidekiq['metrics_enabled'] = false     

        postgresql['shared_buffers'] = "64MB"
        postgresql['max_worker_processes'] = 1
        sidekiq['concurrency'] = 1
      
        nginx['worker_processes'] = 1
        postgresql['shared_buffers'] = "64MB"
        prometheus_monitoring['enable'] = false

这里需要注意。 gitlab 1.3之后采用了 puma来控制web访问
最后登陆gitlab，将初始化git仓库就可以了。

最后

code-server + md + git 这一套比较方便的是在电脑上记录笔记，尤其是在一些不想留存本地文件的地方（公司！），但是一些零碎的想法记录，待办事项还是不够方便。
目前我是
code-server记录笔记，主要是pc pad 端
joplin 记录待办事项，多端通用
flomo 记录一些零碎的想法， 主要是手机端
这三者同时使用基本满足了日常需求。