LeeYzero的博客

自强不息，厚德载物

0%

CentOS搭建CodeServer环境

Posted on Edited on In

Code Server是一个基于VSCode实现的开源的云端IDE，只要能联网，就可以通过浏览器进行访问，无需安装，十分方便。本文主要介绍如何在CentOS 8中安装Code Server。

依赖环境

  • 2GB RAM
  • 需要root权限，对于非root账号，需要sudo权限
  • 需要安装nginx

安装code-server

下载安装包

目前最新版本是 v4.4.0，CentOS下载 code-server-4.4.0-amd64.rpm 包：

1
wget https://github.com/coder/code-server/releases/download/v4.4.0/code-server-4.4.0-amd64.rpm

安装rpm包

1
sudo rpm -i code-server-4.4.0-amd64.rpm

安装好后，配置路径在：~/.config/code-server/config.yaml，修改配置参数：

1
2
3
4
5
$ vim ~/.config/code-server/config.yaml
bind-addr: 127.0.0.1:{port}
auth: password
password: {password}
cert: false

{port}填写你要绑定的端口，127.0.0.1表示只允许本机访问，{password}修改为你的密码，cert证书暂时不需要开启。

可执行文件在/usr/bin/code-server，可以通过-h命名查询命令行参数：

1
2
3
4
5
$ /usr/bin/code-server -h
code-server 4.4.0 b088ec7adf9e17bc75215f79e21498eb40da03ed with Code 1.66.2

Usage: code-server [options] [path]
...

配置code-server.service

1
sudo vim /usr/lib/systemd/system/code-server.service

添以下内容，用户数据配置路径为：~/.local/share/code-server

1
2
3
4
5
6
7
8
9
10
11
[Unit]
Description=code-server
After=nginx.service
 
[Service]
Type=simple
ExecStart=/usr/bin/code-server --config ~/.config/code-server --user-data-dir ~/.local/share/code-server
Restart=always
 
[Install]
WantedBy=multi-user.target

以当前用户身份启动code-server

1
sudo systemctl enable --now code-server@$USER

查看code-server服务是否启动

1
ps -ef | grep code-server

服务正常启动后，可以看到code-server的进程，可以通过http://127.0.0.1:{port}/访问服务了。但现在只允许本机访问，可以通过curl验证：

1
curl -v --location http://127.0.0.1:{port}/

其中{port}在~/.config/code-server/config.yaml中配置。

配置code-server域名

配置nginx

以本机nginx配置目录/etc/nginx为例，确保/etc/nginx/nginx.conf文件包含下列语句：

1
2
3
4
5
6
7
...
http {
    ...
    include /etc/nginx/conf.d/*.conf;
    ...
}
...

在/etc/nginx/conf.d目录下，创建code-server.conf文件：

1
touch /etc/nginx/conf.d/code-server.conf

添加以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
server {
    listen {port};
    listen [::]:{port};
 
    server_name {domain};
 
    location / {
        proxy_pass http://127.0.0.1:8000/;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection upgrade;
        proxy_set_header Accept-Encoding gzip;
    }
}

其中，{port}为监听的端口，{domain}为对外暴露的域名。

启动nginx

1
sudo service nginx restart

检查nginx是否启动

1
ps -ef | grep nginx

测试

用浏览器打开你配置的域名，如果一切正常的话，就可以进入code-server的登录界面，输入在~/.config/code-server/config.yaml中配置的密码即可登录使用vscode了。

配置https

Let’s Entrypt 是一个免费的证书颁发机构（CA），可以提供免费的证书。certbot 提供了一键安装和自动续约功能。

安装步骤参考另一篇文章：免费让网站启用HTTPS

证书安装成功后，在nginx的配置 conf.d/code-server.conf 中，可以看到certbot添加的内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
server {
    ...
    listen [::]:443 ssl ipv6only=on; # managed by Certbot
    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/leeyzero.com/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/leeyzero.com/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
    ...
}

server {
    if ($host = {code-server.your-domain}) {
        return 301 https://$host$request_uri;
    } # managed by Certbot


    listen 80;
    listen [::]:80;

    server_name {code-server.your-domain};
    return 404; # managed by Certbot
}

{code-server.your-domain} 是你访问codeserver的域名，配置完成后，再试访问你的域名，是不是已经变成https了呢？

更新code-server

code-server社区还在不断发展，从官网下载最新版本，如当前最新版本为4.4.0（2022-05-8）使用以下命令更新后按上述步骤重启nginx和code-server即可。

1
sudo rpm -Uvh code-server-4.3.0-amd64.rpm

参考资料

[1] code-server github
[2] code-server install.md
[3] How To Set Up the code-server Cloud IDE Platform on CentOS 7
[4] code-server discussions-4316
[5] letsencrypt.org
[6] certbot.eff.org