drumsergio/lynxprompt

LynxPrompt Docker镜像文档

镜像概述

LynxPrompt是一个自托管平台，用于管理AI IDE配置文件（如AGENTS.md、.cursor/rules/、CLAUDE.md、斜线命令等30+种格式）。通过部署在自有基础设施上，为团队提供集中化 hub，实现AI编码助手配置的创建、共享和标准化，适用于跨项目统一配置管理。

无需为每个项目和AI工具手动编写配置文件，LynxPrompt可通过交互式向导（Web/CLI）生成配置、通过私有或联邦市场共享蓝图、使用可复用模板标准化AI行为，并一键导出至任何支持格式。该平台免费开源，支持个人自托管或企业部署，也提供托管版本（lynxprompt.com）。

核心功能与特性

通用AI配置中心

支持30+种AI编码助手（Cursor、Claude Code、GitHub Copilot、Windsurf、Zed、Aider等），实现"一次编写，多格式导出"。

蓝图市场

组织内部或联邦市场，用于共享AI配置和斜线命令。支持浏览、搜索、收藏和跨团队复用蓝图。

交互式向导

Web和CLI双端可用的分步配置生成器，可从GitHub/GitLab URL自动检测技术栈、框架和仓库结构，支持模板变量、单体仓库层级和草稿自动保存。

灵活认证机制

适配多种环境的认证方式：

• OAuth（GitHub、Google）
• ***（无密码魔法链接登录）
• 密码密钥（WebAuthn生物识别/硬件密钥认证）
• SSO（SAML、OIDC、LDAP企业身份提供商）

可选AI辅助编辑

通过自有Anthropic API密钥启用AI辅助蓝图创建和编辑，完全可选，无API密钥也可正常使用。

完整REST API + CLI工具

提供程序化访问支持自动化和CI/CD集成，可生成API令牌、获取蓝图、搜索和下载。CLI工具（lynxp）镜像Web平台全部功能。

Docker Compose自托管

单条docker compose up命令即可运行完整栈，内置PostgreSQL，启动时自动执行数据库迁移，所有功能可通过环境变量切换。

使用场景与适用范围

• 团队协作：跨项目共享AI配置，统一团队编码标准和AI行为
• 个人开发者：集中管理多个项目的AI助手配置，避免重复工作
• 企业环境：强制实施编码规范，共享机构知识，确保工程团队AI助手行为一致
• 开源项目：提供标准化AI配置模板，降低新贡献者入门门槛

使用方法与配置说明

快速启动（自托管）

bash
# 1. 创建.env文件
cat > .env <<EOF
NEXTAUTH_SECRET=$(openssl rand -base64 32)
ADMIN_EMAIL=your@email.com
APP_URL=http://localhost:3000
EOF

# 2. 下载自托管compose文件并启动LynxPrompt
curl -O https://raw.githubusercontent.com/GeiserX/LynxPrompt/main/docker-compose.selfhost.yml
docker compose -f docker-compose.selfhost.yml up -d

# 3. 打开 http://localhost:3000

默认配置包含PostgreSQL、自动迁移和***认证。

Kubernetes部署（Helm Chart）

Helm Chart适用于Kubernetes部署，完整配置参考图表文档：

bash
helm repo add lynxprompt https://geiserx.github.io/LynxPrompt
helm install lynxprompt lynxprompt/lynxprompt

环境变量配置

所有功能通过环境变量控制，可按需启用/禁用：

CLI工具使用

CLI工具镜像Web平台功能，默认连接lynxprompt.com，可指向自托管实例：

bash
# 安装
npm install -g lynxprompt

# （可选）指向自托管实例 - 两种方式：
lynxp config set-url https://lynxprompt.your-company.com
# 或：export LYNXPROMPT_API_URL=https://lynxprompt.your-company.com

# 认证（在配置的实例上打开浏览器）
lynxp login

# 交互式生成AI配置文件
lynxp wizard

# 拉取蓝图
lynxp pull bp_abc123

# 推送本地配置
lynxp push

# 查看当前CLI配置
lynxp config

API URL存储在CLI配置文件中（可通过lynxp config path查看），LYNXPROMPT_API_URL环境变量优先级更高。也可通过Homebrew（brew install GeiserX/lynxprompt/lynxprompt）和Chocolatey（choco install lynxprompt）安装。

VS Code扩展

官方VS Code扩展支持在编辑器内管理配置：

• 在专用侧边栏浏览云蓝图和本地AI配置文件
• 将AGENTS.md、CLAUDE.md、.cursor/rules/等拉取到正确的工作区路径
• 使用内置编辑器比较本地文件与云版本差异
• 无需离开VS Code即可推送更新到LynxPrompt

从Marketplace安装或运行ext install LynxPrompt.lynxprompt。

架构说明

• 前端+API：Next.js 16（App Router）
• 数据库：PostgreSQL（Prisma ORM）
• 部署：Docker Compose（启动时自动迁移）
• 认证：NextAuth.js（可配置提供商）
• 搜索：PostgreSQL全文搜索

支持单数据库或多数据库设置，根据规模需求调整。