OpenRun单节点部署教程适合小型团队的轻量级解决方案【免费下载链接】openrunDeployment platform for code-first internal tools. Deploy web apps declaratively, on a single-node or on Kubernetes, with OIDC/SAML auth and RBAC.项目地址: https://gitcode.com/gh_mirrors/cl/openrunOpenRun是一款专为代码优先的内部工具设计的部署平台它通过声明式配置让团队能够轻松部署Web应用程序。对于小型团队来说单节点部署是最简单、最快速的入门方式无需复杂的Kubernetes集群配置即可享受完整的应用部署和管理功能。为什么选择OpenRun单节点部署对于中小型团队来说OpenRun的单节点部署方案提供了完美的平衡点极简安装只需几分钟即可完成部署无需复杂的集群配置零运维负担自动处理TLS证书、容器管理和应用路由成本效益在单台服务器上运行资源利用率高无缝扩展未来可平滑升级到Kubernetes集群无需修改应用配置完整功能包含RBAC权限控制、审计日志、GitOps等企业级功能 准备工作与环境要求在开始部署之前请确保您的环境满足以下要求操作系统Linux、macOS或Windows支持WSL容器运行时Docker或Podman推荐Docker内存至少2GB可用内存存储至少10GB可用磁盘空间网络可访问GitHub仓库用于获取应用代码安装容器运行时如果您还没有安装Docker可以参考以下快速安装命令# Ubuntu/Debian sudo apt update sudo apt install docker.io # CentOS/RHEL sudo yum install docker sudo systemctl start docker sudo systemctl enable docker # macOS使用Homebrew brew install docker 快速安装OpenRun单节点OpenRun提供了多种安装方式我们推荐使用官方安装脚本这是最简单快捷的方法使用安装脚本推荐对于大多数用户使用官方安装脚本是最佳选择curl -sSL https://openrun.dev/install.sh | sh安装脚本会自动完成以下操作下载最新版OpenRun二进制文件创建必要的配置文件生成管理员密码设置环境变量安装完成后您会看到类似下面的输出OpenRun installed successfully! Admin password: xxxxxxxx Please add to your shell profile: export OPENRUN_HOME$HOME/openrun export PATH$OPENRUN_HOME/bin:$PATH重要提示请记下显示的管理员密码您将需要它来访问OpenRun控制台。更新环境变量打开新的终端窗口或者重新加载您的shell配置文件# Bash用户 source ~/.bashrc # Zsh用户 source ~/.zshrc⚙️ 配置与启动OpenRun服务生成配置文件OpenRun使用TOML格式的配置文件。如果您使用安装脚本配置文件已自动生成。如需手动生成openrun password $OPENRUN_HOME/openrun.toml启动OpenRun服务器启动服务非常简单openrun server start服务启动后您将看到类似以下输出2026/07/20 08:57:00 Starting OpenRun server 2026/07/20 08:57:00 Using config file: /home/user/openrun/openrun.toml 2026/07/20 08:57:00 Server listening on https://localhost:25223 2026/07/20 08:57:00 HTTP redirect listening on http://localhost:25222验证安装打开浏览器访问 https://localhost:25223使用以下凭据登录用户名admin密码安装时生成的管理员密码 部署您的第一个应用OpenRun支持声明式应用部署这意味着您可以通过配置文件来管理应用而不是通过命令行操作。示例应用系统工具集合让我们部署一个实用的系统工具集合应用openrun apply --approve github.com/openrundev/openrun/examples/utils.star这个命令会从GitHub仓库获取应用配置并自动部署。应用包含多个实用工具文件浏览器浏览服务器文件系统磁盘使用分析可视化磁盘空间使用情况系统信息查看服务器运行状态访问已部署的应用部署完成后您可以在浏览器中访问应用列表https://localhost:25223磁盘使用分析https://localhost:25223/disk_usage文件浏览器https://localhost:25223/files 高级配置选项自定义端口和绑定地址如果您需要修改默认端口或绑定到特定网络接口可以编辑配置文件# 在openrun.toml中添加以下配置 [server] address 0.0.0.0:25223 # 绑定到所有网络接口 http_address 0.0.0.0:25222启用自动TLS证书对于生产环境您可以启用Lets Encrypt自动证书[server] auto_tls true email your-emailexample.com domains [your-domain.com]配置数据库默认情况下OpenRun使用SQLite数据库。对于更高负载的场景可以配置PostgreSQL[database] type postgres url postgres://user:passwordlocalhost:5432/openrun 监控与管理查看服务状态# 查看服务状态 openrun server status # 查看服务日志 tail -f $OPENRUN_HOME/logs/openrun.log应用管理命令# 列出所有应用 openrun app list # 查看应用详情 openrun app show /disk_usage # 重启应用 openrun app restart /disk_usage # 删除应用 openrun app delete /disk_usage审计日志所有操作都会记录在审计日志中️ 安全配置最佳实践1. 修改默认管理员密码首次登录后建议立即修改管理员密码openrun user password admin --new-password 您的强密码2. 启用OAuth/OIDC认证对于团队使用建议配置OAuth认证[auth] type oauth provider github # 支持github, gitlab, google等 client_id your-client-id client_secret your-client-secret3. 配置RBAC权限基于角色的访问控制可以精细管理团队权限[[rbac]] user developerteam.com role developer apps [/dev/*] [[rbac]] user adminteam.com role admin apps [*] 自动化部署与GitOpsOpenRun支持GitOps工作流可以自动同步Git仓库中的配置变更配置自动同步openrun sync schedule --approve --promote github.com/openrundev/openrun/examples/utils.star查看同步状态openrun sync list 故障排除常见问题及解决方案端口被占用# 检查端口占用 sudo lsof -i :25223 # 修改配置文件中的端口 # 编辑openrun.toml修改server.address容器启动失败# 检查Docker服务状态 sudo systemctl status docker # 查看容器日志 docker logs container_id证书问题# 重新生成本地证书 mkcert -install权限问题# 确保用户有权限访问Docker sudo usermod -aG docker $USER获取帮助查看详细日志tail -f $OPENRUN_HOME/logs/openrun.log检查服务状态openrun server status重置配置删除配置文件并重新生成 性能优化建议资源限制配置对于资源受限的环境可以配置资源限制[container] memory_limit 512M cpu_limit 0.5应用休眠策略OpenRun支持空闲应用自动休眠以节省资源[app] idle_timeout 30m # 30分钟无访问后休眠缓存配置优化静态资源缓存[server] static_cache_ttl 24h brotli_compression true 总结OpenRun的单节点部署方案为小型团队提供了一个强大而简单的内部工具部署平台。通过本教程您已经学会了✅快速安装和配置OpenRun✅部署和管理Web应用程序✅配置安全和权限控制✅实现自动化部署流程✅监控和故障排除技巧OpenRun的单节点部署不仅安装简单还提供了企业级的功能包括RBAC权限控制、审计日志、自动TLS证书管理等。随着团队规模的增长您可以无缝升级到Kubernetes集群部署而无需修改任何应用配置。现在就开始使用OpenRun让您的内部工具部署变得更加简单高效吧官方文档docs/content/docs/Installation.md示例应用examples/disk_usage/容器配置docs/content/docs/Container/Overview.md【免费下载链接】openrunDeployment platform for code-first internal tools. Deploy web apps declaratively, on a single-node or on Kubernetes, with OIDC/SAML auth and RBAC.项目地址: https://gitcode.com/gh_mirrors/cl/openrun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考