---
title: "Deploy perplexity-ai"
description: "用你的 Perplexity 订阅额度，自建 OpenAI 兼容 API + MCP 服务，自带号池管理面板与中英文界面。"
category: "AI/ML"
url: https://railway.com/deploy/perplexity-ai
---

# Deploy perplexity-ai

用你的 Perplexity 订阅额度，自建 OpenAI 兼容 API + MCP 服务，自带号池管理面板与中英文界面。

**[Deploy perplexity-ai on Railway](https://railway.com/template/perplexity-ai)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/perplexity-ai/manifest.json

- **Creator:** Bu Junjie's Projects
- **Category:** AI/ML

## Template content

### perplexity-mcp

- **Source:** https://github.com/wsbjj/perplexity-ai-railway
- **Public domain:** Yes

## Documentation

# Deploy and Host Perplexity MCP Server on Railway

用你自己的 Perplexity 订阅额度，自建一套 **OpenAI 兼容 API + MCP 服务**，并自带号池管理面板。

> Self-host an OpenAI-compatible API and MCP server on top of your own Perplexity
> subscription, with a built-in multi-account pool dashboard.

本项目是 [escapeWu/perplexity-ai](https://github.com/escapeWu/perplexity-ai) 的 fork，
已针对 Railway 适配：Dockerfile 构建、`/ready` 健康检查、失败自动重启、管理面板中英文切换、
`reasoning_effort` 兼容。

## About Hosting Perplexity MCP Server

部署后你会得到一个单容器服务：

- 对外提供 `/v1/models`、`/v1/chat/completions`（OpenAI 兼容）与 `/mcp`（MCP 协议）
- 浏览器打开 `/admin/` 是号池管理面板（支持中英文切换），`/playground/` 是在线调试台
- 服务监听 **8000** 端口，健康检查路径 `/ready`
- 模版已创建持久卷挂载到 `/app/data`，用于保存账号配置、日志、模型缓存与会话数据库

它不做模型推理，而是复用你浏览器登录 Perplexity 的会话 cookie，把网页版内部接口翻译成标准协议。
消耗的是订阅里的网页版额度（Pro Search、Deep Research），不是官方 API 额度。

## Why Deploy Perplexity MCP Server

- 想把 Perplexity 接到 Cherry Studio、LobeChat、NextChat、opencodex、Codex 等客户端里统一使用
- 想让自己支持 MCP 的编码工具获得实时联网检索与深度调研能力
- 想用多个 Perplexity 账号做轮询与高可用，而不是手动切来切去
- 不想把 cookie 交给任何第三方在线服务，服务跑在你自己账号的 Railway 项目里

## Common Use Cases

- 在 OpenAI 兼容客户端里使用 Perplexity 的 GPT / Claude / Gemini / Grok 等联网模型
- 给 Claude Code、Codex 之类的 MCP 客户端接上 `perplexity_ask_v2`（实时搜索）与
  `perplexity_research_v2`（深度调研）
- 多账号号池：加权调度、失败退避、Cookie 每 6 小时自动续期，失效时可选 Telegram 提醒
- 通过管理面板查看每个账号的权重、请求计数、失败次数与实时日志

## Dependencies for Perplexity MCP Server

### Deployment Dependencies

| 依赖 | 说明 |
| --- | --- |
| Perplexity 订阅账号 | 至少一个；Pro 账号会解锁十几个模型，Max 账号可额外使用 Max 专属模型 |
| 浏览器登录态 | 需要从已登录 perplexity.ai 的浏览器里复制会话 cookie |
| Railway 账号 | 用于托管服务与持久卷 |
| 两个密钥 | `MCP_TOKEN`（接口认证）与 `PPLX_ADMIN_TOKEN`（管理面板），随机字符串即可 |

#### 部署时必填的变量

| 变量 | 说明 |
| --- | --- |
| `MCP_TOKEN` | 调用 `/v1/*` 与 MCP 接口的密钥，随机字符串即可（`openssl rand -hex 32`） |
| `PPLX_ADMIN_TOKEN` | 登录 `/admin/` 管理面板的密钥，与上面那个不要混用 |

#### 部署后三步

**1. 生成公网域名**
服务 → Settings → Networking → Generate Domain，目标端口填 `8000`（不是 8080）。

**2. 验证服务**
```bash
D=https://你的域名
curl -s $D/health      # {"status":"healthy",...}
curl -s $D/ready       # {"status":"ready"}
```

**3. 绑定 Perplexity 账号**
打开 `https://你的域名/admin/`，用 `PPLX_ADMIN_TOKEN` 登录，点 NEW TOKEN：

- 标识：任意好认的名字
- Cookies：登录 perplexity.ai → F12 → Network → 刷新 → 点任意发往 `www.perplexity.ai`
  的请求 → Request Headers → 复制 `cookie:` 后面那一整串

面板会自动挑出 `__Secure-pplx.session.UUID` 和 `__Host-pplx-last-active-account`，
丢弃 `cf_clearance`、`__cf_bm` 等临时 cookie。绑定完成后 `/v1/models` 会从 1 个
降级模型变成你订阅可用的全部模型。

#### 客户端接入

```
OpenAI 兼容:  https://你的域名/v1      密钥 = MCP_TOKEN
MCP:          https://你的域名/mcp     头部 = Authorization: Bearer MCP_TOKEN
```

#### 注意事项

- 不支持 function calling / 工具调用，适合问答、检索与调研，不适合当代码 agent 的主力模型。
- 本项目通过逆向网页版接口实现，违反 Perplexity 使用条款，存在限流或封号风险。
- cookie 等同账号登录态，卷里的配置文件是明文存储，请勿分享给他人。
- 仅供个人学习与研究使用。


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/perplexity-ai