跳到主要内容

环境初始化

本节将指导您完成基础环境的配置，包括 Docker 安装和必要的系统设置。

安装 Docker​

Docker 是运行 Mytesla 服务的核心组件，我们需要安装 Docker Engine 和 Docker Compose。

Linux 系统​

Ubuntu/Debian 系统​

# 更新包管理器
sudo apt update && sudo apt upgrade -y

# 安装必要的依赖包
sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release \
    wget \
    git

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 添加 Docker 仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# 添加当前用户到 docker 组
sudo usermod -aG docker $USER

# 启动并启用 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

CentOS/RHEL 系统​

# 安装必要的包
sudo yum install -y yum-utils device-mapper-persistent-data lvm2

# 添加 Docker 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# 安装 Docker Engine
sudo yum install -y docker-ce docker-ce-cli containerd.io

# 启动并启用 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

# 添加当前用户到 docker 组
sudo usermod -aG docker $USER

macOS 系统​

  1. 访问 Docker Desktop for Mac 官网
  2. 下载适合您处理器架构的版本（Intel 或 Apple Silicon）
  3. 安装并启动 Docker Desktop
  4. 确保 Docker Desktop 正在运行

Windows 系统​

  1. 确保启用 WSL2 功能
  2. 访问 Docker Desktop for Windows 官网
  3. 下载并安装 Docker Desktop
  4. 启动 Docker Desktop 并确保使用 WSL2 引擎

🔧 安装 Docker Compose​

Linux 系统​

# 下载最新版本的 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 创建软链接（可选）
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

macOS/Windows​

Docker Desktop 已包含 Docker Compose，无需单独安装。

验证安装​

重新登录系统（或执行 newgrp docker ）后，验证安装是否成功：

# 检查 Docker 版本
docker --version

# 检查 Docker Compose 版本
docker-compose --version

# 测试 Docker 是否正常工作
docker run hello-world

# 检查 Docker 服务状态
docker system info

预期输出类似：

Docker version 24.0.x, build xxxxx
Docker Compose version v2.20.x
Hello from Docker!
...

创建项目目录​

创建一个专门的目录来存放 Mytesla 相关文件：

# 创建项目目录
mkdir -p ~/mytesla
cd ~/mytesla

常见问题​

Permission denied​

如果遇到权限错误：

# 确保用户在 docker 组中
sudo usermod -aG docker $USER

# 重新登录或执行
newgrp docker

Docker 服务无法启动​

# 检查服务状态
sudo systemctl status docker

# 查看详细日志
sudo journalctl -u docker.service

端口被占用​

# 检查端口使用情况
sudo netstat -tlnp | grep :4000

# 停止占用端口的进程
sudo kill -9 <PID>