。

---

• 直接发布
• 和

---

已确认包含以下关键项：

app = 'omniroute'
primary_region = 'sin'

[[mounts]]
  source = 'data'
  destination = '/data'

[processes]
  app = 'node run-standalone.mjs'

[http_service]
  internal_port = 20128

[env]
  TZ = "Asia/Shanghai"
  HOST = "0.0.0.0"
  HOSTNAME = "0.0.0.0"
  BIND = "0.0.0.0"

决定实际部署到哪个 Fly 应用
• 决定持久卷挂载目录
• ，否则数据库和密钥会写到容器临时目录

---

pwsh -Command "iwr https://fly.io/install.ps1 -useb | iex"

二进制并放到 中。

flyctl auth login

flyctl auth whoami
flyctl version

---

git clone https://github.com/diegosouzapw/OmniRoute.git
cd OmniRoute

，重点看这一行：

app = 'omniroute'

app = 'omniroute-yourname'

里 一致的应用
• ，不要和 混淆

flyctl apps create omniroute

替换成你的名字。

flyctl deploy

---

应用上实际部署：

• (生产环境必需 / required in production / obrigatório em produção — 用于 WebSocket 桥接鉴权 / used for WebSocket bridge authentication)

，因为本次部署按需求不使用它。

---

非常关键，必须与 Fly Volume 挂载点一致
• 用于调度器和前端回调等场景

设置 指向你公开的 HTTPS 域名 (set to the public HTTPS domain / defina para o domínio HTTPS público)

flyctl secrets set NEXT_PUBLIC_BASE_URL=https://omniroute.fly.dev -a omniroute

)。

1. 在 provider 控制台配置回调 URL (configure the callback URL on the provider console / configure a URL de callback no painel do provider)

   <NEXT_PUBLIC_BASE_URL>/api/oauth/<provider>/callback
   

   与 provider 控制台中注册的回调 URL 不一致，OAuth 流程会在浏览器回跳阶段失败 (mismatch between and the registered callback URL will cause OAuth to fail at the browser redirect step / divergência entre e a URL de callback registrada quebra o OAuth no redirect do navegador)。

---

$apiKeySecret = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower()
$jwtSecret = [Convert]::ToHexString((1..64 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower()
$machineIdSalt = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower()
$storageKey = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower()
$wsBridgeSecret = [Convert]::ToHexString((1..32 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 })).ToLower()

flyctl secrets set `
  API_KEY_SECRET=$apiKeySecret `
  JWT_SECRET=$jwtSecret `
  MACHINE_ID_SALT=$machineIdSalt `
  STORAGE_ENCRYPTION_KEY=$storageKey `
  OMNIROUTE_WS_BRIDGE_SECRET=$wsBridgeSecret `
  DATA_DIR=/data `
  NEXT_PUBLIC_BASE_URL=https://omniroute.fly.dev `
  -a omniroute

生成 (on Linux / macOS, you can also use / em Linux / macOS, também é possível usar )：

flyctl secrets set OMNIROUTE_WS_BRIDGE_SECRET=$(openssl rand -hex 32) -a omniroute

在生产环境必需，缺失会导致 WebSocket 桥接握手失败 (required in production; missing it breaks WebSocket bridge handshake / obrigatório em produção; sem ele o handshake da ponte WebSocket falha)

flyctl secrets set INITIAL_PASSWORD=你的强密码 -a omniroute

---

flyctl secrets list -a omniroute

页面没有显示你期待的变量，先检查：

• 的 是否和控制台应用一致

---

git pull
flyctl deploy

flyctl secrets set KEY=value -a omniroute

的更新，推荐按下面流程执行。

git remote -v

指向你自己的 fork
• 指向原仓库

，先添加：

git remote add upstream https://github.com/diegosouzapw/OmniRoute.git

git fetch upstream --tags

git describe --tags --always
git show --no-patch --oneline v3.4.7

(current project version is / a versão atual do projeto é )。下文中的 仅为历史示例 (the references below are kept as historical examples only / as referências a abaixo são apenas exemplos históricos)；实际发布时请使用 或当前版本标签 (e.g. ) (use or the current version tag — e.g. — for actual releases / use ou a tag da versão atual — p.ex. — em releases reais)。

，并强制保留 fork 当前的 ，可按下面流程执行：

git merge upstream/main
git checkout HEAD~1 -- fly.toml
git add -- fly.toml
git commit -m "chore(deploy): keep fork fly.toml"
git push origin main

用于同步原仓库最新代码
• 用于恢复合并前你 fork 自己的
• ，这一步不会带来额外差异
• ，这一步能确保 Fly 应用名、挂载卷、区域等 fork 自定义部署配置不被覆盖

，也可以先确认标签是否已经包含在 ：

git merge-base --is-ancestor v3.4.7 upstream/main

已经包含该版本，直接合并 即可。

时使用的实际流程 (示例为历史版本，当前实际版本是 / example refers to a historical version; the current actual version is / o exemplo refere-se a uma versão histórica; a versão atual é )。

---

flyctl status -a omniroute

flyctl logs --no-tail -a omniroute

try {
  (Invoke-WebRequest -Uri "https://omniroute.fly.dev" -MaximumRedirection 5 -UseBasicParsing).StatusCode
} catch {
  if ($_.Exception.Response) {
    $_.Exception.Response.StatusCode.value__
  } else {
    throw
  }
}

说明站点已正常响应。

---

[bootstrap] Secrets persisted to: /data/server.env
[DB] SQLite database ready: /data/storage.sqlite

说明运行时密钥落到了持久卷
• 说明数据库写入持久卷

，说明 没配对，需要立即修正。

---

页面是空的

• ，不是

报

flyctl apps create omniroute

解析失败

中是否存在
• 是否设置为

是否能跑

。生产环境建议尽快修改后台密码。

---

里的
3. 、、、

---

flyctl auth whoami
flyctl status -a omniroute
flyctl secrets list -a omniroute
flyctl deploy
flyctl logs --no-tail -a omniroute

flyctl deploy