跳到主要内容

框架清单

🎯 概述​

Anima 提供了针对主流 Web 框架的 SDK 和插件，让你无需手动管理隧道，只需在项目中安装对应的包，启动开发服务器时自动创建隧道。

核心优势：

  • ✅ 零配置，开箱即用
  • ✅ 开发服务器启动时自动创建隧道
  • ✅ 进程退出时自动清理
  • ✅ 支持热重载
  • ✅ 团队成员即装即用

🚀 支持的框架​

Node.js 生态​

框架语言安装包文档
Express.jsNode.js@anima/express查看文档
Next.jsReact@anima/next查看文档
Koa.jsNode.js@anima/koa查看文档
FastifyNode.js@anima/fastify查看文档

Python 生态​

框架语言安装包文档
FlaskPythonanima-flask查看文档
DjangoPythonanima-django查看文档
FastAPIPythonanima-fastapi查看文档

PHP 生态​

框架语言安装包文档
LaravelPHPanima/laravel查看文档
SymfonyPHPanima/symfony-bundle查看文档

Go 生态​

框架语言安装包文档
GinGogithub.com/anima/gin-tunnel查看文档
EchoGogithub.com/anima/echo-tunnel查看文档

Ruby 生态​

框架语言安装包文档
RailsRubyanima-rails查看文档
SinatraRubyanima-sinatra查看文档

🔧 通用配置​

环境变量​

# 必需配置
ANIMA_TOKEN=your-token-here

# 可选配置
ANIMA_SUBDOMAIN=myapp
ANIMA_ENABLED=true
ANIMA_LOG_LEVEL=info

安全最佳实践​

// ✅ 推荐：只在开发环境启用
if (process.env.NODE_ENV === 'development') {
  app.use(anima({ /* ... */ }));
}

// ❌ 危险：不要在生产环境启用
app.use(anima({ /* ... */ }));

📊 高级功能​

完整配置选项​

anima({
  // 必需配置
  token: process.env.ANIMA_TOKEN,
  
  // 隧道配置
  subdomain: 'myapp',
  region: 'cn-shanghai',
  
  // 功能开关
  enabled: true,
  autoStart: true,
  openBrowser: true,
  copyToClipboard: true,
  
  // 安全配置
  allowedIPs: ['192.168.1.0/24'],
  password: 'secret',
  
  // 团队协作
  shareWith: ['team@example.com'],
  maxConnections: 10,
  
  // 回调函数
  onReady: (url) => console.log(`隧道就绪: ${url}`),
  onError: (error) => console.error(`错误: ${error}`),
})

🔗 相关链接​

注意：目前这些 SDK 还在开发中。如果你对某个框架特别感兴趣，欢迎 提交 Issue 让我们知道！