记一次在 Termux 上搭建 code-server 环境
店里的电脑装着 Windows7，许多开发工具不能安装，因此有了远程开发的需求。说起远程开发，我第一个想到的肯定是 GitHub Codespaces。但这玩意服务器在国外，而且店里的宽带运营商是世界加钱可及的某信，裸连 GitHub Codespaces 时访问速度高达几十 kb/s。正好最近买了一台新手机，我准备在它上面借助 Termux 搭建 code-server 环境。
要求
- 会使用 Linux
- 有一个域名（没有的话可以尝试折腾 hosts 文件）
- 有一部可以完美运行 Termux 的安卓手机
- 有一台安装了 ssh 工具（Git 已经内置）和浏览器的电脑
安装 Termux
点击下面的链接，在 Assets 里下载合适的安装包。大多数安卓/哄蒙机应该选择文件名含 arm64 的安装包。
https://github.com/termux/termux-app/releases/latest
附：对于已开启纯净模式的哄蒙系统，安装时可能需要断网。
安装开发工具
更换清华 Termux 镜像（可选）
启动 Termux，初始化完成后执行以下命令：
termux-change-repo
确保 Main repository 被选中，然后按下回车，再使用上下键将光标移至清华镜像后按下空格和回车。
安装和配置开发工具
依次执行以下命令：
#一股脑把需要的全装上
pkg install git nodejs-lts nginx python3 openssl-tool wget openssh vim screen -y
pkg up
#在这里查 code-server 的最新版本号，然后替换下面的版本号
#https://github.com/search?q=repo%3Atermux-user-repository%2Fdists%20dists%2Ftur-packages%2Ftur%2Fbinary-aarch64%2FPackages%20code-server&type=code
wget https://ghproxy.com/https://github.com/termux-user-repository/dists/releases/download/0.1/code-server_4.17.1_aarch64.deb -O code-server.deb
apt-get --fix-broken install ./code-server.deb -y
#网快的也可以用这个
pkg install tur-repo -y
pkg install code-server -y
#更换淘宝源
npm config set registry https://registry.npmmirror.com
#将邮箱和用户名分别替换为 GitHub 绑定的邮箱和 GitHub 用户名
git config --global user.email "username@example.com"
git config --global user.name "username"
注意：安装时看见 The default action is to keep your current version. 这句话可直接按回车
为手机设置固定内网 IP
打开 WLAN 设置，按住已连接的网络，点击 “修改网络”。
点击“IP”，将“DHCP”改为“静态”。
然后 参考 以下设置，修改后保存。
- IP 地址：
192.168.1.xx
- 网关：
192.168.1.1
- 网络前缀长度：
24
- 域名 1：
192.168.1.1
- 域名 2：
114.114.114.114
配置域名
为域名添加以下记录：
| 类型 |
名称 |
值 |
| A |
vscode |
<手机内网 IP> |
| A |
*.vscode |
<手机内网 IP> |
如果没有域名，可以在 hosts 文件里添加以下内容
#将 example.com 替换为你自己的域名
手机内网IP vscode.example.com
手机内网IP <需要转发的端口1>.vscode.example.com
手机内网IP <需要转发的端口2>.vscode.example.com
手机内网IP <需要转发的端口3>.vscode.example.com
...
配置自签名证书
注意：必须妥善保管证书文件，泄露给他人有安全风险。
执行以下命令：
cd ~
mkdir ssl
cd ssl
vim ./csr.conf
按 i 进入编辑模式，粘贴以下内容：
[req]
default_bits = 2048
prompt = no
default_md = sha256
req_extensions = req_ext
distinguished_name = dn
[dn]
C = CN
CN = foo
O = bar
[req_ext]
subjectAltName = @alt_names
[alt_names]
#将 example.com 替换为你自己的域名
DNS.1 = vscode.example.com
DNS.2 = *.vscode.example.com
DNS.3 = localhost
IP.1 = <手机内网IP>
IP.2 = 127.0.0.1
按 Esc，输入 :wq 并按回车后执行命令 vim ./cert.conf，再按 i 进入编辑模式，粘贴以下内容：
authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names
[alt_names]
#将 example.com 替换为你自己的域名
DNS.1 = vscode.example.com
DNS.2 = *.vscode.example.com
DNS.3 = localhost
IP.1 = <手机内网IP>
IP.2 = 127.0.0.1
按 Esc，输入 :wq 并按回车后，依次执行以下命令：
openssl req -x509 -sha256 -days 3560 -nodes -newkey rsa:2048 -subj "/CN=foo/C=CN/O=bar" -keyout rootCA.key -out rootCA.crt
openssl genrsa -out server.key 2048
openssl req -new -key server.key -out server.csr -config csr.conf
openssl x509 -req -in server.csr -CA rootCA.crt -CAkey rootCA.key -CAcreateserial -out server.crt -days 365 -sha256 -extfile cert.conf
cd ~
配置 ssh 服务
依次执行以下命令：
#设置密码，密码不会显示出来，输完后请自信按下回车
passwd
sshd
#显示内网 IP 地址
ifconfig
现在可以在同一局域网内另一台安装了 ssh 客户端的机器上执行以下命令，然后输入密码：
ssh -p 8022 手机内网IP
如果显示下面的文字，输入 yes 并按回车
ED25519 key fingerprint is SHA256:balabala.
This key is not known by any other names
Are you sure you want to continue connecting (yes/no/[fingerprint])?
安装根证书
以 Windows 系统为例，在同一局域网内另一台安装了 ssh 客户端的机器上执行以下命令，然后输入密码：
scp -P 8022 username@手机内网IP:~/ssl/rootCA.crt .
双击打开证书文件，点击“安装证书”，将证书添加到“受信任的根证书颁发机构”。
配置 Nginx
执行命令 vim ~/../usr/etc/nginx/nginx.conf，再按 i 进入编辑模式，删除已有内容，然后粘贴以下内容：
worker_processes 1;
events {
worker_connections 1024;
}
http {
sendfile on;
keepalive_timeout 65;
gzip on;
#如果显示“could not build server_names_hash, you should increase server_names_hash_bucket_size”，可以将下面的数字改为更大的 32 的倍数
server_names_hash_bucket_size 64;
server {
listen 7443 ssl;
#将 example.com 替换为你自己的域名
server_name *.vscode.example.com;
ssl_certificate /data/data/com.termux/files/home/ssl/server.crt;
ssl_certificate_key /data/data/com.termux/files/home/ssl/server.key;
ssl_session_cache shared:SSL:1m;
ssl_session_timeout 5m;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
location / {
set $forward_port -1;
if ($host ~ ^([0-9]+)\. ) {
set $forward_port $1;
}
if ($forward_port = -1) {
return 400;
}
proxy_pass http://127.0.0.1:$forward_port;
proxy_set_header Host $proxy_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
}
按 Esc，输入 :wq 并按回车。
编写启动脚本
执行命令 vim ~/android-as-linux.js，再按 i 进入编辑模式，删除已有内容，粘贴以下内容：
Object.defineProperty(process, "platform", {
get() {
return "linux";
},
});
按 Esc，输入 :wq 并按回车，然后执行命令 vim ~/code-server.sh，再按 i 进入编辑模式，删除已有内容，粘贴以下内容：
#!/data/data/com.termux/files/usr/bin/bash
sshd
nginx -s quit
nginx
cat ~/.config/code-server/config.yaml
#见下方注意事项
export NODE_OPTIONS="--require /data/data/com.termux/files/home/android-as-linux.js"
#将 example.com 替换为你自己的域名
code-server --host 0.0.0.0 --port 8443 --cert ~/ssl/server.crt --cert-key ~/ssl/server.key --proxy-domain vscode.example.com:7443
按 Esc，输入 :wq 并按回车，然后依次执行以下命令：
chmod 777 ~/code-server.sh
~/code-server.sh
退出按 Ctrl + C 并执行 nginx -s quit
至此，完整的开发环境已经准备好。在同一局域网内另一台机器上打开浏览器，在地址栏输入 vscode.example.com（将 example.com 替换为你自己的域名）并输入密码，就可以愉快地敲代码了。
注意事项
扩展
这里贴上官网的警告
Note that Android and Linux are not 100% compatible, so use these workarounds at your own risk. Extensions that have native dependencies ther than Node or that directly interact with the OS might cause issues.
这句话的意思是：上面强制让 code-server 认为它现在在 Linux 平台上跑的行为可能会出惹出一些问题：直接调用操作系统接口/包含二进制可执行文件的扩展可能无法正常运行，因为 Android 和 Linux 不完全兼容，出了问题你负责。
还有，code-server 的扩展由 Open VSX Registry 提供，但是一些扩展在这并没有上架，这时可以在 Visual Studio Marketplace 上面找到需要的扩展，然后点击右侧的“Download Extension”。下载后将扩展文件拽到右侧的资源管理器，再点击右键 > 安装扩展 VSIX。
顺便推荐一些我正在用的扩展：
厚着脸皮给自己打广告 4399 on VSCode：在 VSCode 上玩 4399 小游戏- Code Spell Checker：检查代码里的拼写错误，并给出修改建议
- Comment Translate：翻译代码里的注释，支持替换需要翻译的文字
- ESLint：规范代码风格
- Gitmoji：快速在 Git 提交信息里插入 Emoji 表情
- Path Intellisense：快速补全路径
- Prettier：更漂亮的代码格式化工具
]]>
