Linux本地部署OpenHands：基于AI的软件开发代理平台

OpenHands 是一个革命性的开源项目，它提供了一个基于AI的软件开发代理平台，能够自动执行编码任务、修复Bug、生成代码片段等。本文将指导你在Linux系统上完整部署OpenHands，并通过公网访问，让你随时随地享受AI编程助手的服务。关键词包括：OpenHands、AI软件开发代理、Linux部署、公网访问。

1. 环境准备

首先，确保你的Linux系统（推荐Ubuntu 20.04或更高版本）已经安装以下基础工具：

• Git：sudo apt install git -y
• Docker 和 Docker Compose：sudo apt install docker.io docker-compose -y
• Python3 和 pip：sudo apt install python3 python3-pip -y

2. 克隆OpenHands项目

使用Git将OpenHands仓库克隆到本地：

git clone https://github.com/OpenHands/openhands.gitcd openhands

3. 配置API密钥

OpenHands需要调用大语言模型API（如OpenAI、Anthropic等）。在项目根目录创建.env文件：

# 示例：使用OpenAIOPENAI_API_KEY=你的OpenAI密钥MODEL=gpt-4

其他配置可参考官方文档，这一步是AI软件开发代理正常运行的关键。

4. 使用Docker启动OpenHands

OpenHands提供了Docker镜像，可以一键启动所有服务：

docker-compose up -d

等待镜像拉取和容器启动，执行docker ps查看运行状态。

5. 本地验证

启动后，OpenHands默认监听3000端口。在浏览器访问http://localhost:3000，你应该能看到OpenHands的Web界面。至此，Linux部署成功！

6. 配置公网访问

要让OpenHands可以从公网访问，我们使用内网穿透工具ngrok。首先安装ngrok：

# 下载并安装ngrokwget https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-v3-stable-linux-amd64.tgztar xvzf ngrok-v3-stable-linux-amd64.tgzsudo mv ngrok /usr/local/bin/

注册ngrok账号并获取authtoken（点击这里），然后配置：

ngrok config add-authtoken 你的authtokenngrok http 3000

执行后，ngrok会生成一个公网URL（如https://xxxx.ngrok.io），通过该URL即可从任何地方访问你的OpenHands。这样就实现了公网访问。

7. 安全与优化

公网暴露服务需要注意安全：建议在OpenHands前端添加身份验证（如使用nginx反向代理+Basic Auth），或者限制IP访问。另外，可以考虑使用更稳定的frp进行内网穿透。