Railway CLI技能：使用命令行高效管理Railway部署和基础设施

railway by mshumer/claude-skill-railway

112 周安装量

25 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/mshumer/claude-skill-railway --skill railway

云服务开发运维命令行工具

🇨🇳中文介绍

包含 Shell 命令

此技能包含可能执行系统命令的 shell 命令指令（!command``）。安装前请仔细审查。

Railway CLI 技能

使用 Railway CLI 管理 Railway 部署和基础设施。

预检检查

当前状态：!railway status 2>&1 || echo "NOT_LINKED"

自动恢复

在运行任何命令之前，请检查上面的预检状态：

如果显示 "command not found" ：运行 npm install -g @railway/cli
如果显示 "Not logged in" ：告知用户手动运行 railway login（需要浏览器）
如果显示 "NOT_LINKED" 或 "No project linked" ：
- 运行 railway list 以显示可用项目
- 询问用户要链接哪个项目，或从 package.json 名称自动检测
- 使用 railway link -p <project-id> 进行链接

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

"status"（无参数时的默认操作）

railway status
railway domain
railway deployment list --limit 1

报告：项目信息、URL 以及上次部署状态/时间。

解析自然语言选项：

"errors" → --filter "@level:error"
"last hour" / "1h" → --since 1h
"build" → --build
数字如 "100" → --lines 100

默认：railway logs --lines 30

总结输出 - 高亮错误、警告或有趣的模式。

然后等待并检查：

运行 railway deployment list --limit 1 获取状态
如果成功，获取域名 URL 并验证其响应：curl -s -o /dev/null -w "%{http_code}" <domain>
如果失败，显示构建日志：railway logs --build --lines 50

重新部署但不重建。适用于环境变量更改。

重启服务，无需重建或重新部署。

"vars" / "env" [操作]

重要提示：显示变量时，对敏感值进行脱敏处理：

API 密钥：显示前 8 个字符 + "..."
密码：显示 "********"
令牌：显示前 8 个字符 + "..."

设置：railway variables set KEY=value 删除：railway variables delete KEY（首先请求确认！）

"deployments" / "history"

railway deployment list --limit 10

格式化为表格，包含：ID（简短）、状态、时间前、提交信息（截断）

显示公共 URL。如果不存在，则提供创建一个。

然后 curl 域名以检查 HTTP 状态：

curl -s -o /dev/null -w "%{http_code}" -m 10 <domain-url>

报告是否健康（2xx）、不健康或无法访问。

在浏览器中打开 Railway 仪表板。

通过名称（模糊匹配）切换到不同的 Railway 项目。

# 列出所有项目
railway list

查找与名称匹配的项目 ID，然后：

railway link -p <project-id>

使用 railway status 确认切换。

连接到项目的数据库 shell（Postgres、MongoDB、Redis 等）

如果存在多个数据库，Railway 将提示选择一个。

列出可用项目并链接一个：

以编号列表形式显示项目。询问用户要链接哪个，然后：

railway link -p <project-id>

在执行破坏性操作之前，请求确认：

railway down - 移除部署
railway variables delete - 移除环境变量
railway unlink - 取消链接项目

格式："这将执行 [操作]。确定吗？(y/n)"

摘要：单行状态（✓ 成功 / ✗ 失败 / ⚠ 警告）
详细信息：以清晰的表格或列表形式提供相关信息
URL：公共 URL（如果适用）
后续步骤：如果某些操作失败，建议如何修复

✓ MyApp 已部署且运行正常

| 项目        | MyApp                                    |
| 环境        | production                               |
| 服务        | MyApp                                    |
| URL         | https://myapp-production.up.railway.app  |
| 上次部署    | 2 小时前 (SUCCESS)                       |

✓ 部署成功

构建在 45 秒内完成
URL: https://myapp-production.up.railway.app
健康检查: 200 OK

✗ 部署失败

第 23 行构建错误：未找到模块 'xyz'

建议修复：运行 `npm install xyz` 并重新部署

2026 年 1 月 22 日

🇺🇸English

Contains Shell Commands

This skill contains shell command directives (!command``) that may execute system commands. Review carefully before installing.

Railway CLI Skill

Manage Railway deployments and infrastructure using the Railway CLI.

Pre-flight Check

Current status: !railway status 2>&1 || echo "NOT_LINKED"

Auto-Recovery

Before running any command, check the pre-flight status above:

If "command not found" : Run npm install -g @railway/cli
If "Not logged in" : Tell user to run railway login manually (requires browser)
If "NOT_LINKED" or "No project linked" :
- Run railway list to show available projects
- Ask user which project to link, or auto-detect from package.json name
- Link with railway link -p <project-id>

Command Routing

Based on $ARGUMENTS, execute the appropriate workflow:

"status" (default when no args)

railway status
railway domain
railway deployment list --limit 1

Report: project info, URL, and last deployment status/time.

"logs" [options]

Parse natural language options:

"errors" → --filter "@level:error"
"last hour" / "1h" → --since 1h
"build" → --build
Number like "100" → --lines 100

Default: railway logs --lines 30

Summarize output - highlight errors, warnings, or interesting patterns.

"deploy" / "up"

railway up

Then wait and check:

Run railway deployment list --limit 1 to get status
If SUCCESS, fetch the domain URL and verify it responds: curl -s -o /dev/null -w "%{http_code}" <domain>
If FAILED, show build logs: railway logs --build --lines 50

"redeploy"

railway redeploy

Redeploys without rebuilding. Useful for env var changes.

"restart"

railway restart

Restarts the service without rebuild or redeploy.

"vars" / "env" [action]

railway variables

IMPORTANT : When displaying variables, redact sensitive values:

API keys: show first 8 chars + "..."
Passwords: show "********"
Tokens: show first 8 chars + "..."

For setting: railway variables set KEY=value For deleting: railway variables delete KEY (ask for confirmation first!)

"deployments" / "history"

railway deployment list --limit 10

Format as a table with: ID (short), Status, Time ago, Commit message (truncated)

"domain"

railway domain

Show the public URL. If none exists, offer to create one.

"health"

railway domain

Then curl the domain to check HTTP status:

curl -s -o /dev/null -w "%{http_code}" -m 10 <domain-url>

Report if healthy (2xx), unhealthy, or unreachable.

"open"

railway open

Opens the Railway dashboard in browser.

"switch "

Switch to a different Railway project by name (fuzzy match).

# List all projects
railway list

Find the project ID that matches the name, then:

railway link -p <project-id>

Confirm the switch with railway status.

"db" / "connect"

Connect to the project's database shell (Postgres, MongoDB, Redis, etc.)

railway connect

If multiple databases exist, Railway will prompt to select one.

"link"

List available projects and link one:

railway list

Show projects in a numbered list. Ask user which to link, then:

railway link -p <project-id>

Safety Guards

Before destructive operations, ask for confirmation:

railway down - removes deployment
railway variables delete - removes env var
railway unlink - unlinks project

Format: "This will [action]. Are you sure? (y/n)"

Response Format

Always provide:

Summary : One-line status (✓ success / ✗ failure / ⚠ warning)
Details : Relevant information in a clean table or list
URL : Public URL if applicable
Next steps : If something failed, suggest how to fix it

Example Responses

Status check:

✓ MyApp is deployed and healthy

| Project     | MyApp                                    |
| Environment | production                               |
| Service     | MyApp                                    |
| URL         | https://myapp-production.up.railway.app  |
| Last deploy | 2 hours ago (SUCCESS)                    |

After deploy:

✓ Deployment successful

Build completed in 45s
URL: https://myapp-production.up.railway.app
Health check: 200 OK

On error:

✗ Deployment failed

Build error at line 23: Module not found 'xyz'

Suggested fix: Run `npm install xyz` and redeploy

Weekly Installs

108

Repository

mshumer/claude-…-railway

GitHub Stars

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykWarn

Installed on

claude-code93

opencode89

codex88

gemini-cli81

cursor79

github-copilot63

Railway CLI技能：使用命令行高效管理Railway部署和基础设施

🇨🇳中文介绍

Railway CLI 技能

预检检查

自动恢复

相关 Skills

命令路由

"status"（无参数时的默认操作）

"logs" [选项]

"deploy" / "up"

"redeploy"

"restart"

"vars" / "env" [操作]

"deployments" / "history"

"domain"

"health"

"open"

"switch "

"db" / "connect"

"link"

安全防护

响应格式

示例响应

🇺🇸English

Railway CLI Skill

Pre-flight Check

Auto-Recovery

Command Routing

"status" (default when no args)

"logs" [options]

"deploy" / "up"

"redeploy"

"restart"

"vars" / "env" [action]

"deployments" / "history"

"domain"

"health"

"open"

"switch "

"db" / "connect"

"link"

Safety Guards

Response Format

Example Responses

最新 Skills