Linux本地部署开源项目OpenHands基于AI的软件开发代理平台及公网访问

2025-04-28 11:37:21 1 阅读

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老
导航
檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等
常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等
数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等
新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等
懒人运维系列:总结好用的命令,解放双手不香吗?能用一个命令完成绝不用两个操作
数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝 ✨✨ 欢迎订阅本专栏 ✨✨

博客目录

- 前言
- 1. Linux 部署 OpenHands
- 2. OpenHands 功能介绍
- 3. 公网使用 OpenHands
- - 3.1 内网穿透工具安装
  - 3.2 创建远程连接公网地址
- 4. 固定 OpenHands 公网地址

前言

本篇文章介绍如何在 Linux 本地部署开源项目 OpenHands 基于人工智能的软件开发代理平台，并结合 cpolar 实现公网访问。

OpenHands（此前称为 OpenDevin）是一个基于人工智能的软件开发代理平台，旨在通过 AI 技术增强软件开发流程。该平台支持开发者执行各种任务，包括代码编写、命令行操作以及网页浏览等，其功能几乎与人类开发者相当。

OpenHands 采用 MIT 许可证发布，并强调社区驱动的开发模式。项目主要使用 Python 编程语言构建，同时运行依赖于 Docker 环境。因此，熟悉容器化技术对于贡献或使用该项目尤为重要。

OpenHands 代理可以执行人类开发人员可以执行的任何操作：修改代码、运行命令、浏览网页、调用 API，甚至从 StackOverflow 复制代码片段。

接下来本地部署 OpenHands。

1. Linux 部署 OpenHands

本篇文章演示环境：Ubuntu22.04

运行 OpenHands 最简单的方法是使用 Docker 进行部署，如果没有安装 Docker，可以查看这篇教程进行安装：Docker 安装——Linux、Windows、MacOS - cpolar 极点云官网

输入以下命令来运行以下命令拉取 OpenHands 镜像：

sudo docker pull docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik

使用以下命令启动 OpenHands 容器：

sudo docker run -it --pull=always 
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik 
    -e LOG_ALL_EVENTS=true 
    -v /var/run/docker.sock:/var/run/docker.sock 
    -p 3000:3000 
    --add-host host.docker.internal:host-gateway 
    --name openhands-app 
    docker.all-hands.dev/all-hands-ai/openhands:0.14

打开浏览器输入 localhost:3000 启动并可以访问。

2. OpenHands 功能介绍

首次运行时，会弹出设置窗口。

用户需要选择 LLM 提供商、LLM 模型并输入 API 密钥。
可通过点击 UI 中的齿轮图标随时调整设置。如需使用自定义模型，可在高级选项中手动输入模型名称和 Base URL。

设置好后，点击 Save 保存

接下来验证下 OpenHands，输入下提示词请求，例如：请编写一个 bash 脚本 hello.sh,打印 “hello world!”

回到 OpenHands，可以看到左侧显示提示词，右侧给出了对应回答

接下来我想让他使用 HTML 创建一个简单的计算器，点击生成，可以看到右侧出现了相应文件的代码

在输入框中让它运行这个项目，可以看到在对话框中输出了链接

验证一下这个简单的计算器生成是否正确，这里我使用 VsCode 打开并运行代码。

一个简易的计算器就生成好了，如果不满意就可以回到 OpenHands，继续输入要求生成新的代码。

虽然在本地环境中部署 OpenHands 已经能够显著提升你的开发效率，但如果你希望从任何地方都能随时随地访问这个强大的工具，就需要解决内网穿透的问题。这时，Cpolar 就成为了你的得力助手。

Cpolar 是一款功能强大且易于使用的内网穿透工具，它能够在几秒钟内将你的本地服务暴露到公网上。无论你是在办公室、家里还是在旅途中，Cpolar 都能确保你能够轻松访问 OpenHands，而无需复杂的网络配置或昂贵的服务器托管费用。

接下来教大家如何安装 Cpolar 并且将 OpenHands 实现公网使用。

3. 公网使用 OpenHands

3.1 内网穿透工具安装

下面是安装 cpolar 步骤：

Cpolar 官网地址: https://www.cpolar.com

使用一键脚本安装命令

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看 cpolar 服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar 安装和成功启动服务后，在浏览器上输入 ubuntu 主机 IP 加 9200 端口即:【http://localhost:9200】访问 Cpolar 管理界面，使用 Cpolar 官网注册的账号登录,登录后即可看到 cpolar web 配置界面,接下来在 web 界面配置即可：

3.2 创建远程连接公网地址

隧道名称：可自定义，本例使用了: openhands 注意不要与已有的隧道名称重复
协议：http
本地地址：3000
域名类型：随机域名
地区：选择 China Top

创建成功后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了两个公网地址，接下来就可以在其他电脑（异地）上，使用任意一个地址在浏览器中访问即可。

如下图所示，成功实现使用公网地址异地远程访问本地部署的 OpenHands，跟上面一样，配置好模型即可使用。

使用上面的 cpolar https 公网地址，在任意设备的浏览器进行访问，即可成功看到 OpenHands 界面，这样一个利用公网地址可以进行远程访问的隧道就创建好了，隧道使用了 cpolar 的公网域名，无需自己购买云服务器，可节省大量资金。使用 cpolar 创建隧道即可发布到公网进行远程访问，新域名登录，可能需要重新登陆!