跳到主要内容

🚀 快速开始

欢迎使用 Anima!根据你的使用场景,我们提供两种快速开始方式:

🎯 选择你的使用方式

方式一:框架集成 🔥 推荐

如果你使用的是主流 Web 开发框架(Express、Next.js、Flask、Django、Laravel 等),我们提供了原生集成方案:

  • 零配置:一行代码开启隧道
  • 自动管理:开发服务器启动时自动创建隧道
  • 即用即走:进程退出自动清理隧道

👉 查看框架集成教程 →


方式二:传统安装

如果你需要手动管理隧道,或者使用自定义应用,请继续阅读下面的安装步骤。

📋 前置条件

  • macOS: 10.14 或更高版本
  • Linux: Ubuntu 18.04+ / CentOS 7+ / Debian 9+
  • Windows: Windows 10 或更高版本
  • 稳定的网络连接
  • 管理员权限(用于安装)

⚡ 传统安装:5 分钟快速上手

第一步:安装客户端

🚀 一键安装(推荐)

# 自动检测系统并安装
curl -fsSL https://anima4.cn/install.sh | bash

📦 手动安装

macOS (Apple Silicon):

curl -L https://anima4.cn/downloads/anima-macos-arm64.tar.gz | tar -xz
sudo mv anima /usr/local/bin/

macOS (Intel):

curl -L https://anima4.cn/downloads/anima-macos-amd64.tar.gz | tar -xz
sudo mv anima /usr/local/bin/

Linux (x86_64):

curl -L https://anima4.cn/downloads/anima-linux-amd64.tar.gz | tar -xz
sudo mv anima /usr/local/bin/

Linux (ARM64):

curl -L https://anima4.cn/downloads/anima-linux-arm64.tar.gz | tar -xz
sudo mv anima /usr/local/bin/

Windows:

# 下载并解压到当前目录
curl -L https://anima4.cn/downloads/anima-windows-amd64.tar.gz | tar -xz

# 将 anima.exe 添加到 PATH 环境变量中

验证安装:

anima --version

第二步:注册账户

  1. 访问 Anima 管理后台
  2. 点击"注册"按钮
  3. 输入邮箱和密码
  4. 验证邮箱地址

第三步:获取 API Token

  1. 登录管理后台
  2. 前往 设置API Token
  3. 复制你的专属 Token

第四步:配置客户端

# 初始化配置
anima config init

按提示输入:

  • 服务器地址anima4.cn:443
  • API Token:从管理后台复制的 Token

第五步:创建第一个隧道

# 创建 HTTP 隧道
anima tunnel create \
--name my-webapp \
--type http \
--local-port 3000 \
--subdomain myapp

# 启动隧道
anima tunnel start my-webapp

第六步:访问你的服务

打开浏览器访问:https://myapp.anima4.cn

🎉 完成! 你的本地服务现在可以通过公网访问了。

📚 下一步

🆘 遇到问题?