Skip to main content

方式二：下载安装

本指南将详细介绍如何在不同平台上安装 Anima 客户端。

🍎 macOS 安装​

系统要求​

  • macOS 10.14 (Mojave) 或更高版本
  • 网络连接
  • 管理员权限（用于安装）

方法一：一键安装（推荐）​

curl -fsSL https://anima4.cn/install.sh | bash

方法二：Homebrew​

# 添加 tap
brew tap anima-dev/tap

# 安装
brew install anima

# 验证安装
anima --version

方法三：手动安装​

Apple Silicon Mac (ARM64)​

# 下载二进制文件
curl -L https://anima4.cn/downloads/anima-macos-arm64.tar.gz | tar -xz

# 安装到系统
sudo mv anima /usr/local/bin/

# 验证安装
anima --version

Intel Mac (x86_64)​

# 下载二进制文件
curl -L https://anima4.cn/downloads/anima-macos-amd64.tar.gz | tar -xz

# 安装到系统
sudo mv anima /usr/local/bin/

# 验证安装
anima --version

🐧 Linux 安装​

系统要求​

  • Ubuntu 18.04+ / CentOS 7+ / Debian 9+
  • 网络连接
  • sudo 权限

方法一：一键安装​

curl -fsSL https://anima4.cn/install.sh | bash

方法二：包管理器​

Ubuntu/Debian​

# 下载 .deb 包
wget https://anima4.cn/downloads/anima-linux-amd64.deb

# 安装
sudo dpkg -i anima-linux-amd64.deb

# 验证安装
anima --version

CentOS/RHEL/Fedora​

# 下载 .rpm 包
wget https://anima4.cn/downloads/anima-linux-amd64.rpm

# 安装
sudo rpm -i anima-linux-amd64.rpm

# 验证安装
anima --version

方法三：手动安装​

x86_64 架构​

# 下载并解压
curl -L https://anima4.cn/downloads/anima-linux-amd64.tar.gz | tar -xz

# 移动到系统路径
sudo mv anima /usr/local/bin/

# 验证安装
anima --version

ARM64 架构​

# 下载并解压
curl -L https://anima4.cn/downloads/anima-linux-arm64.tar.gz | tar -xz

# 移动到系统路径
sudo mv anima /usr/local/bin/

# 验证安装
anima --version

🪟 Windows 安装​

系统要求​

  • Windows 10 或更高版本
  • PowerShell 5.0+ 或 Windows Terminal
  • 网络连接
  • 管理员权限（用于添加到 PATH）

方法一：一键安装​

# 使用 PowerShell 运行安装脚本
Invoke-Expression (Invoke-WebRequest -Uri "https://anima4.cn/install.ps1" -UseBasicParsing).Content

方法二：手动安装​

  1. 下载二进制文件
# 下载 Windows 版本
curl -L https://anima4.cn/downloads/anima-windows-amd64.tar.gz -o anima-windows.tar.gz

# 解压（需要 tar 工具，Windows 10 1803+ 自带）
tar -xzf anima-windows.tar.gz
  1. 添加到系统 PATH

方法 A：通过系统设置

  1. 右键"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 点击"环境变量"
  4. 在"系统变量"中找到"Path"，点击"编辑"
  5. 添加包含 anima.exe 的目录路径

方法 B：通过 PowerShell（需要管理员权限）

# 假设 anima.exe 在 C:\anima\ 目录
$animaPath = "C:\anima"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$animaPath", [EnvironmentVariableTarget]::Machine)
  1. 验证安装
# 重新打开 PowerShell 窗口
anima --version

方法三：使用 Chocolatey​

# 安装 Chocolatey（如果未安装）
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 安装 Anima
choco install anima

方法四：使用 Scoop​

# 安装 Scoop（如果未安装）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# 添加 Anima bucket（如果存在）
scoop bucket add anima https://github.com/anima-dev/scoop-bucket

# 安装 Anima
scoop install anima

🐳 Docker 安装​

拉取镜像​

docker pull anima/client:latest

运行容器​

# 基本运行
docker run -d --name anima-client anima/client:latest

# 挂载配置文件
docker run -d --name anima-client \
  -v ~/.anima:/root/.anima \
  anima/client:latest

Docker Compose​

创建 docker-compose.yml：

version: '3.8'
services:
  anima-client:
    image: anima/client:latest
    container_name: anima-client
    volumes:
      - ~/.anima:/root/.anima
    restart: unless-stopped

启动服务：

docker-compose up -d

✅ 安装验证​

检查版本​

anima --version

预期输出：

anima version 1.0.0
build date: 2025-01-10
commit: abc123def456

检查帮助信息​

anima --help

测试网络连接​

anima ping

🔄 更新客户端​

自动更新（推荐）​

anima update

手动更新​

# 停止所有隧道
anima tunnel stop --all

# 下载新版本
curl -fsSL https://anima4.cn/install.sh | bash

# 重启隧道
anima tunnel start --all

🗑️ 卸载客户端​

macOS/Linux​

# 停止所有隧道
anima tunnel stop --all

# 删除二进制文件
sudo rm /usr/local/bin/anima

# 删除配置文件（可选）
rm -rf ~/.anima

Docker​

# 停止并删除容器
docker stop anima-client
docker rm anima-client

# 删除镜像（可选）
docker rmi anima/client:latest

🚨 故障排除​

权限问题​

# 如果遇到权限错误
sudo chmod +x /usr/local/bin/anima

# 检查 PATH 环境变量
echo $PATH

网络问题​

# 检查网络连接
ping anima4.cn

# 检查防火墙设置
sudo ufw status  # Ubuntu/Debian
sudo firewall-cmd --list-all  # CentOS/RHEL

下载问题​

# 使用 wget 代替 curl
wget https://anima4.cn/downloads/anima-macos-arm64.tar.gz

# 手动下载
# 访问 https://github.com/anima-dev/anima/releases

📞 获取帮助​

如果在安装过程中遇到问题，请：

  1. 查看 客户端使用指南
  2. 访问 GitHub Issues
  3. 加入社区讨论：GitHub Discussions
  4. 联系技术支持：support@anima.dev