当前位置：首页 > 系统教程 > 正文

OpenHands本地部署全攻略（Linux系统下AI软件开发代理平台搭建与公网访问教程）

主机测评网
系统教程
2026-01-03
262

OpenHands本地部署全攻略（Linux系统下AI软件开发代理平台搭建与公网访问教程）

OpenHands是一个基于AI的软件开发代理平台，能够自动化代码生成、测试和部署，提升开发效率。本教程将详细指导您在Linux系统上完成OpenHands部署，并配置公网访问，即使您是新手也能轻松上手。通过本指南，您将掌握OpenHands部署的核心步骤，实现AI软件开发平台的本地运行和远程访问。

一、准备工作：环境与依赖安装

在开始OpenHands部署前，请确保您使用Linux系统（如Ubuntu 20.04），并具备基本命令行操作知识。本教程以Ubuntu为例，其他发行版类似。

1. 系统更新：首先更新包列表，确保系统最新。sudo apt update && sudo apt upgrade -y

2. 安装依赖：OpenHands基于Python开发，需安装Python3、pip和Git。sudo apt install python3 python3-pip git -y验证安装：python3 --version 和 git --version。

二、部署OpenHands：克隆与配置

接下来，我们将从开源仓库获取OpenHands代码并完成配置。这是OpenHands部署的关键步骤。

1. 克隆仓库：使用Git克隆OpenHands官方仓库到本地。git clone https://github.com/openhands-project/OpenHands.git进入目录：cd OpenHands

2. 安装Python包：安装项目所需的Python依赖。pip3 install -r requirements.txt如果遇到权限问题，可添加 --user 标志。

3. 配置文件：根据项目文档配置环境变量。复制示例文件并编辑。cp config.example.yaml config.yaml使用文本编辑器（如nano）设置API密钥等参数：nano config.yaml。

OpenHands本地部署全攻略（Linux系统下AI软件开发代理平台搭建与公网访问教程） OpenHands部署 AI软件开发平台 Linux教程公网访问配置第1张

三、运行OpenHands平台

完成配置后，启动OpenHands服务以验证部署。此步骤将运行AI软件开发代理平台。

运行启动命令：python3 app.py或根据项目说明使用：python3 main.py。

服务启动后，在浏览器中访问 http://127.0.0.1:5000（端口可能不同，请查看终端输出）。如果看到OpenHands界面，说明本地部署成功。

四、公网访问配置：从本地到远程

要使OpenHands能从公网访问，需配置内网穿透或反向代理。这里介绍两种常用方法，确保公网访问配置安全稳定。

方法一：使用Ngrok（快速测试）Ngrok提供临时公网隧道，适合演示或测试。1. 下载Ngrok：从官网获取Linux版本，解压。2. 认证：./ngrok authtoken 您的token3. 启动隧道：./ngrok http 50004. Ngrok会生成公网URL（如 https://abc.ngrok.io），通过它即可远程访问OpenHands。

方法二：使用Nginx反向代理（生产环境）Nginx提供更稳定的公网访问配置，适合长期使用。1. 安装Nginx：sudo apt install nginx -y2. 创建站点配置文件：sudo nano /etc/nginx/sites-available/openhands添加以下内容（调整端口和域名）：

server {    listen 80;    server_name your-domain.com或公网IP;    location / {        proxy_pass http://127.0.0.1:5000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}

3. 启用配置并重启：sudo ln -s /etc/nginx/sites-available/openhands /etc/nginx/sites-enabled/sudo nginx -t 测试配置，然后 sudo systemctl restart nginx。4. 配置防火墙：允许80端口（sudo ufw allow 80），完成后通过公网IP或域名访问OpenHands。

五、总结与关键词

通过本教程，您已成功在Linux系统上完成了OpenHands部署，这是一个强大的AI软件开发代理平台，并实现了公网访问配置。现在，您可以远程使用OpenHands进行AI辅助开发，提升团队协作效率。本Linux教程覆盖了从环境准备到公网访问的全过程，确保小白用户也能轻松上手。如有问题，请参考OpenHands官方文档。

SEO关键词： OpenHands部署, AI软件开发平台, Linux教程, 公网访问配置。这些关键词在文章中已自然融入，以提升搜索可见性。