巧用 VScode 网页版 IDE 搭建个人笔记知识库!_业界新闻

发布时间:2024-07-19 02:22

阅读量:1

[ 知识是人生的灯塔，只有不断学习，才能照亮前行的道路 ]

巧用 VScode 网页版 IDE 搭建个人笔记知识库!

描述：最近自己在腾讯云轻量云服务器中部署了一个使用在线 VScode 搭建部署的个人Markdown在线笔记，考虑到在线 VScode 支持终端模式，可以用来做各种开发环境搭建以及代码运行调试等，同时也为恶意攻击者提供了一个攻击入口，所以考虑到安全性问题，就打算将整个在线 VScode 容器进行离线，不让访问互联网，也能进一步保证无法调用外部接口进行反弹Shell以及避免其他一些必须联网攻击的手段，下面请看整个实现过程。

原文链接：巧用 VScode 网页版 IDE 搭建个人笔记知识库!最近自己在腾讯云轻量云服务器中部署了一个使用在线 VScode 搭建部署的个人Markdown在线笔记，考虑到支持终端模式，给恶意攻击者提供了一个攻击入口，所以考虑到安全性问题，就打算将整个在线 VScode 容器进行离线，不让访问互联网。https://mp.weixin.qq.com/s/Mn1-o9Z6SY9L3UtH-SJCOA

前置说明

描述：在上一章作者已经介绍了在线 VScode 搭建部署的整个过程，这里就不再赘述了，直接进入正题，请按照《VS Code网页版IDE，每个程序猿必备一套!》文章中的要求进行基础环境进行配置, 此处作者推荐一下vscode中常用的开发插件，希望对各位开发者有帮助。

Chinese (Simplified) : 适用于 VS Code 的中文（简体）语言包
vscode-icons: Visual Studio 代码的图标
markdown All in One: 提供Markdown编辑的全方位支持，包括实时预览、语法提示、目录生成、表格生成等多种功能。
Markdown Preview Enhanced: 支持实时预览 Markdown 文件效果，并具备导出 PDF、支持数学公式、流程图等多种高级功能，提供了丰富的定制选项和兼容性，极大地提升了 Markdown 文档的编辑和预览体验。
Go : 对Visual Studio代码的Rich Go语言支持
Database Client：Database manager for MySQL/MariaDB, PostgreSQL, SQLite, Redis and ElasticSearch.
SQLite：Explore and query SQLite databases.
Live Server: 启动具有静态和动态页面实时重新加载功能的本地开发服务器
ESLint : 将ESLint JavaScript集成到VS代码中
wakatime：记录每天coding的时间
:emojisense: 自动追加添加emoji表情符号
Surround: 用于在代码块周围添加包装代码片段，JS前端必备。
CSS Peek：它允许开发者直接从HTML文档中快速跳转到匹配的CSS样式定义，并提供预览功能，从而大大提高CSS样式的查找和编辑效率。
Regex Previewer：可以实时预览正则表达式匹配结果，并适用于多种前端框架和语言，同时提供快捷键操作、全局和多行选项等便捷功能，以提升开发效率。
Code Spell Checker ：可以检查单词拼写是否出现错误，检查的规则遵循 camelCase （驼峰拼写法）
i18n Ally: 主要用于国际化多语言开发，提供内联提示、快速修改key值对应的语言文件、统一管理翻译、自动翻译等功能。
Turbo Console Log : 一键生成有意义的 console.log 消息，支持多语言、多光标操作，提供可定制的日志类型和输出格式，提高调试效率。
indent-rainbow: 一款代码缩进可视化插件，它通过为文本前面的缩进着色，使缩进更具可读性。
Remote-SSH: 允许开发者通过 SSH 协议连接到远程服务器或虚拟机，直接在本地 VS Code 编辑器中操作远程服务器上的代码，实现无缝的远程开发体验。
Vue - Official : Vue 官方扩展。
JavaScript (ES6) code snippets: 通过此插件可以使用预定义的 ES6 语法片段速记，从而提高开发效率。
Import Cost: 在项目中导入多个包时可能会出现性能问题，Import Cost 就用于查看将特定库导入项目的成本。
VS Code Counter: 插件用于统计项目代码的行数，
Highlight Matching Tag : 用于实时高亮显示匹配的标签对，方便用户在 HTML 或 XML 代码中快速找到配对的标签。
TODO Highlight: 实时高亮显示代码中的TODO、FIXME等标记，支持自定义关键字和正则表达式匹配，方便开发者快速识别、管理和追踪待办事项。
Better comments: 该插件对不同类型的注释会附加了不同的颜色，更加方便区分，帮助我们在代码中创建更人性化的注释。
Colorize: 给颜色代码增加一个当前匹配代码颜色的背景。它通过 CSS 变量、预处理器变量、hsl/hsla 颜色、跨浏览器颜色、exa、rgb、rgba和argb的彩色背景将 CSS 颜色可视化，帮助开发者快速区分颜色。
Image preview: 通过此插件，当鼠标悬浮在图片的链接上时，可以实时预览该图片，除此之外，还可以看到图片的大小和分辨率。
CodeSnap: 用于对代码的进行截图和共享。屏幕截图可以用文本或形状进行注释，并通过链接共享或包含在网站或文档中。只需使用 ctrl + shift + P 并输入 CodeSnap，然后按回车键，CodeSnap 窗口就会打开。

除此之外，建议将 Markdown 笔记放在个人 Gitlab 或者 Gitee 、Github 等代码托管平台中，这样方便进行版本管理以及备份。

weiyigeek.top-全栈工程师个人笔记知识图

温馨提示：作者最近10年的工作学习笔记（涉及网络、安全、运维、开发、机器学习），需要学习实践笔记的看友，可添加作者账号[WeiyiGeeker]，目前价格￥199，除了获得从业笔记的同时还可进行问题答疑,相关工具以及每月远程技术支持，希望各位看友多多支持，收获定大于付出！下面大致看看作者笔记中的大纲内容。

weiyigeek.top-作者笔记1图

weiyigeek.top-作者笔记2图

weiyigeek.top-作者笔记3图

weiyigeek.top-作者笔记4图

weiyigeek.top-作者笔记5图

weiyigeek.top-作者笔记6图

操作步骤

Step 1.将个人笔记代码仓库克隆到本地，并进入/opt/code-server/project/目录中, 初次使用 SSH 协议进行代码克隆、推送等操作时，需按下述提示完成 SSH 配置，在Gitee上做公密钥认证（https://gitee.com/profile/sshkeys）就不在累述了。

# 安装 git apt install git  # 生成获取 RSA 公密钥 ssh-keygen -t rsa cat ~/.ssh/id_rsa.pub  # 拉取笔记 cd /opt/code-server/project/ git clone git@gitee.com:WeiyiGeek/blog.git  # 设置目录文件权限（只有root用户可读可写，其他用户只读）, 防止大家误修改笔记！ chown -R root:root /opt/code-server/project/blog chown -R 754 /opt/code-server/project/blog

Step 2.创建一个docker-compose.yaml文件，并编写如下内容，其中DOCKER_USER=ubuntu表示容器内用户为ubuntu，TZ=Asia/Shanghai设置时区，并进行在线vscode的一些安全配置，禁用一部分功能以及禁止访问到外网（PS: com.docker.network.bridge.enable_ip_masquerade），最后将个人笔记代码仓库挂载到容器中。

tee /opt/code-server/docker-compose.yaml <<EOF version: '3.9' services:   vscode-server:     container_name: code-server     image: registry.cn-hangzhou.aliyuncs.com/weiyigeek/code-server:latest     command: --bind-addr 0.0.0.0:8080 --disable-update-check --disable-file-downloads --disable-file-uploads --disable-proxy --ignore-last-opened --disable-getting-started-override --welcome-text "欢迎访问，全栈工程师修炼必备笔记站点!"     user: "1000:1000"     ports:       - 127.0.0.1:3002:8080     environment:       - TZ=Asia/Shanghai       - DOCKER_USER=ubuntu     volumes:       - /opt/code-server/.local:/home/coder/.local       - /opt/code-server/.config:/home/coder/.config       - /opt/code-server/project/blog/source/_posts:/home/coder/project     dns:       - 127.0.0.1       - 127.0.1.1     networks:       - private  networks:   private:     driver: bridge     driver_opts:       com.docker.network.bridge.enable_ip_masquerade: 'false' EOF

Step 3.部署资源清单创建容器，并且验证容器状态是否正常。

$ docker-compose up -d $ docker ps   # CONTAINER ID   IMAGE                                                            COMMAND                  CREATED       STATUS       PORTS                                       NAMES   # cd290e6326f5   registry.cn-hangzhou.aliyuncs.com/weiyigeek/code-server:latest   "/usr/bin/entrypoint…"   12 days ago   Up 12 days   127.0.0.1:3002->8080/tcp                    code-server  # 进入容器验证是否能访问外网（可以参考已经无法访问外网了） $ docker exec -it code-server bash ubuntu@cd290e6326f5:~$ curl -I  weiyigeek.top curl: (6) Could not resolve host: weiyigeek.top

Step 4.然后访问作者前面搭建部署的1panle面板进行，通过使用Openresty中间件（若没有安装可参考此篇《部署OpenResty一个基于 Nginx 与 Lua 的高性能 Web 平台》文章），设置在线VScode的反向代理地址http://127.0.0.1:3002到443端口访问，并配置好域名解析到note.weiyigeek.top。

location ^~ / {   proxy_pass http://127.0.0.1:3002;    proxy_set_header Host $host;    proxy_set_header X-Real-IP $remote_addr;    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    proxy_set_header REMOTE-HOST $remote_addr;    proxy_set_header Upgrade $http_upgrade;    proxy_set_header Connection "upgrade";    proxy_set_header X-Forwarded-Proto $scheme;    proxy_http_version 1.1;    add_header X-Cache $upstream_cache_status;    add_header Strict-Transport-Security "max-age=31536000";  }

weiyigeek.top-反向代理设置图

Step 5.为了安全起见，还在 OpenResty 启用了 auth 远程身份认证，为每个购买我笔记的读者分配一个账号密码，在浏览器中输入https://note.weiyigeek.top/进行认证后，即可访问到在线 VScode 网页版中搭建的作者十年的学习工作笔记（PS: 作者通常会在每周五持续更新笔记哟！），最后若有需要笔记的小伙伴们可以添加作者【WeiyiGeeker】，说明来意。