code-server广泛应用于Azure,Google,Reddit等大型互联网公司,这些公司使用code-server为本公司的开发者提供通过浏览器远程编辑代码的能力。
快速入门指南
你只需要简单的几步就可以在本地运行起一个code-server服务。只要你使用的是macOS、windows或者Linux,你就可以轻松地运行code-server的二进制文件。运行起来后,code-server默认监听8443端口。
1、访问发布页,为你的操作系统下载最新的cli工具。
2、双击可执行文件,code-server将在当前文件夹下运行。
3、复制在终端中出现的密码
4、用浏览器打开地址:localhost:8443
5、在登陆界面填入刚刚输入的密码。
注意事项
当你通过IP在本地浏览器访问code-server服务时,你可能会看到这个页面。code-server使用一个自签名的https证书,以便让体验更方便。这个警告无需在意,点击“Advanced”。
然后点击“proceed anyway”
使用方法
code-server还提供了一系列的参数,允许你自定义工作目录、host、端口、SSL证书等信息
数据目录
使用 code-server -d 或者 code-server --data-dir=,来指定 VS Code 启动的根目录。
Host
默认情况下,code-server会使用0.0.0.0作为它的地址。你可以使用-h/--host来指定访问的地址。
Open
你可以要求code-server在启动的同时在浏览器中打开IDE页面,你只需在启动时增加参数 -o/--open。
Port
默认情况下,code-server使用8443作为访问端口。你可以使用-p/--port来指定访问的端口。
证书和证书秘钥
为了保护浏览器和服务器之间的通信安全,你可以指定HTTPS证书。用--cert来指定证书的位置,用--cert-key来指定证书密钥的位置。
Nginx反向代理
这是一个可用的Nginx作为反向代理的配置范例,配合code-server使用时记得增加参数--allow-http。当然,你也可以使用certbot从EFF获取一个免费的证书
帮助
使用-h或者--help参数查看cli的帮助信息。这个命令的输出在上文中有展示。
译者:诗书塞外
英文原文:https://github.com/codercom/code-server/blob/master/doc/self-hosted/index.md