txAdmin 配方是 Recipe Deployer 用来部署 FiveM 服务器的 YAML 文件(recipe.yaml):先下载资源,再写入 server.cfg。该工具通过表单生成配方。
如何使用该工具
填写名称、版本、作者和描述(名称与作者最多 24 个字符,描述最多 256 个字符)。
选择 OneSync,必要时设置 FXServer 最低版本($minFxVersion)。
添加 GitHub 仓库(每行一个,“owner/repo”或“owner/repo@ref”):每个都会下载到 resources/[local]。
列出要启动的资源(ensure),必要时添加额外的 server.cfg 行。
保存 recipe.yaml 并托管(例如放在 GitHub 仓库),然后在 Recipe Deployer 的自定义模板步骤中粘贴其 URL 或内容。
部署器变量
生成的 server.cfg 使用 txAdmin 在部署结束时替换的变量:{{serverEndpoints}}(默认 0.0.0.0:30120)、{{maxClients}}(默认 48)、{{svLicense}}(第 2 步输入的密钥)、{{serverName}}、{{recipeName}}、{{recipeAuthor}},使用数据库时还有 {{dbConnectionString}}。
最佳实践
- 将 “ref” 固定为某个提交或标签,以便可重复部署。
- 执行会在第一个失败的任务处停止:请先在空服务器上测试配方。
- 切勿在配方中写入密码或密钥:请使用部署器变量。
常见问题
- 会生成哪些 txAdmin 动作?
- 会生成 download_github、connect_database(启用时)以及用于 server.cfg 的 write_file。其他动作(download_file、unzip、move_path、replace_string、query_database 等)请参照 txAdmin 文档手动添加。
- 为什么配方里没有许可证密钥?
- 部署器会在第 2 步询问密钥,并在最后替换 server.cfg 中的 {{svLicense}}:密钥绝不应出现在共享文件中。
- 我的数据会被上传吗?
- 不会,所有数据都保存在浏览器(localStorage)中。


