343 words

2 minutes

在Mac Mini 上部署 code-server

2025-10-31

IT

Documents

The open source AI code editor#

环境准备#

在开始部署前，请确保满足以下前置条件：

Homebrew - macOS 包管理器
清华大学镜像源 - 配置指南，加速国内下载
网络环境 - 建议配备稳定的网络访问工具，确保依赖包正常安装

Code-Server 部署方案#

💡 架构建议：对于项目专属的开发环境，推荐使用容器化部署，具备更好的环境隔离和可移植性。

🐳 容器化部署（推荐）#

基于 linuxserver/code-server 镜像的 Docker Compose 方案：

1
services:
2
  code-server:
3
    image: lscr.io/linuxserver/code-server:latest
4
    container_name: code-server
5
    environment:
6
      - PUID=1000
7
      - PGID=1000
8
      - TZ=Asia/Shanghai
9
      - PASSWORD=passwd
10
      - SUDO_PASSWORD=password
11
      - DEFAULT_WORKSPACE=/config/workspace
12
    volumes:
13
      - ./code-server/config:/config
14
    ports:
15
      - 8443:8443
16
    restart: unless-stopped

部署命令：

1
docker compose up -d

配置说明：

将 ./code-server/config 替换为你的本地配置目录
首次启动后可通过 https://localhost:8443 访问
默认工作区位于容器的 /config/workspace 目录

💻 物理机部署#

适用于直接安装在 macOS 系统上的场景：

1
# 通过 Homebrew 安装
2
brew install code-server
3

4
# 启动服务并设置为开机自启
5
brew services start code-server

⚙️ 服务配置#

编辑配置文件 ~/.config/code-server/config.yaml：

1
bind-addr: 0.0.0.0:8080
2
auth: password
3
password: passwd
4
cert: false

📝 重要提醒#

配置生效：修改配置后需执行 brew services restart code-server 重启服务
网络访问：bind-addr 设置为 0.0.0.0，使用 127.0.0.1 无法从外部网络访问
安全考虑：生产环境建议启用 TLS 证书加密通信

在Mac Mini 上部署 code-server

https://jianlongliu.github.io/posts/code-server/

Author

Jianlong Liu

Published at

2025-10-31

License

CC BY-NC-SA 4.0

解决Debian 上安装向日葵远程控制依赖

1

The open source AI code editor