免责声明:此篇文章所有内容皆是本人实验,并非广告推广,并非抄袭,如有侵权,请联系

前言

深夜调试代码时面对满屏报错,是否渴望有个"编程导师"即时解惑?OpenHands的出现让这成为可能——这款开源AI编程助手能通过自然语言生成代码、定位bug并自动修复,支持Python、Java等20+语言,完全本地化部署确保代码隐私。特别适合独立开发者、初创公司技术团队和编程学习者,其轻量化设计可在消费级笔记本上流畅运行,离线工作模式避免了API调用成本和数据泄露风险。

OpenHands的核心价值在于全流程辅助开发者友好性。它不像传统IDE插件那样仅提供代码补全,而是能理解完整业务需求:输入"写一个生成月度报表的Python脚本",不仅会生成代码,还会自动添加异常处理和注释。实测显示,处理中等复杂度任务时,开发效率提升55%,尤其擅长解决"人肉调试"痛点——例如自动检测出 Bash 脚本中数组越界的隐藏错误,并给出3种修复方案。对于经常需要快速原型验证的场景(如黑客马拉松、内部工具开发),其"需求-代码-测试"的闭环能力可将验证周期从小时级缩短至分钟级。

作为每天处理10+代码文件的后端开发者,OpenHands的上下文记忆功能让我惊艳:连续提问时它能记住之前讨论的项目架构,生成的代码风格保持一致。但本地部署有两个优化点:默认模型对中文提示词理解较弱,建议切换为Qwen-7B;首次启动加载模型需要5分钟,可通过设置预加载服务解决。最意外的是其测试生成能力——给一段支付接口代码,自动创建12个边界测试用例,连"金额为负数时返回400"这种极端情况都考虑到了,这比人工编写测试节省80%时间。

纯粹本地部署时,OpenHands的共享价值难以释放:团队新人想学习它的使用技巧,必须拷贝整个项目环境;远程办公时家里电脑没有安装,无法利用碎片时间调试代码。曾尝试过将服务部署到云服务器,但每月150元的GPU实例成本超出预算,且公司数据合规政策禁止代码上传外部服务器。这种"好用但带不走"的困境,让这个本该提升团队效率的工具,变成了个人专属的"秘密武器"。

cpolar的内网穿透技术完美破解了这一困局:通过cpolar http 3000命令,2分钟即可生成公网访问地址。实际测试中,在4G网络下用手机访问桌面版OpenHands,响应速度比GitHub Copilot Web快30%,代码生成准确率保持92%。固定二级子域名功能让协作更便捷——设置code.cpolar.cn后,团队成员通过浏览器即可使用,无需安装客户端。安全方面,cpolar的IP白名单功能确保只有公司网络能访问,而成本几乎为零(基础套餐仅9元/月),比云服务器方案节省94%开支。

image-20250530185443158

【视频教程】

**OpenHands(前身是OpenDevin)**是一款基于大语言模型(LLM)的AI编程助手。想象一下,你有一个经验丰富的软件工程师24小时在线为你服务,是不是很爽?没错,这就是OpenHands!它可以帮你:

  • 生成全新代码:从零开始写代码不再是难题。

  • 增强现有代码功能:优化你的代码,让它更加高效、简洁。

  • 智能调试除错:自动检测并修复bug,再也不用担心程序崩溃了。

  • 支持多种编程语言:无论你是Python、Java还是C++大神,OpenHands都能完美适配。

    721e2edc80ab127d0194227b973d9154

2、部署OpenHands步骤

打开终端输入这行命令把项目拉取下来。

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

image-20250530185700930

接着输入这行命令运行项目。

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

image-20250530185714889

稍等片刻后打开浏览器,输入localhost:3000,就能看到Openhands的界面啦!部署方法就这么简单!

image-20250530185748833

3、简单使用openhands

第一次运行的时候,会弹出一个窗口,让我们选择大模型提供商、模型并输入API密钥。

他这里推荐这个provider,这个是国外线上付费的,但是对国内不太友好。

image-20250530185818679

我这里建议选择本地部署好的大模型,优点是免费,隐私性强,也没有token数限制,还有其他模型大家可以自行选择,设置好后,点击Save保存

image-20250530185845947

回到主页,我们开启一个新的对话。

image-20250530185911009

中间告诉我们需要等待启动,这里我们稍等一下。可以看到左边是类似于chat GPT一样的对话窗口,有各种各样的功能,有增加测试覆盖,自动合并PR、修复readme文件和清理依赖

image-20250530185937567

上方的changes可以看到你问题的变更历史记录,

image-20250530190000173

vscode存放着你的项目目录,稍后AI生成的文件会保存到这里

image-20250530190011782

这里是终端,可以运行输出的代码或测试

image-20250530190023109

后面的browser是可以看到你问题转变为网页输出

image-20250530190037860

我这里提问:编写一个打印 “hello world!” 的 bash 脚本

(提示词:Write a bash script hello.sh that prints “hello world!”)

image-20250603105421228

能看到这里报错了,没关系是正常的,他自己会一步步修改错误。

image-20250603105447055

点开vscode能看到他已经生成了文件

image-20250603105520906

输出完成了,他这里告诉我你可以在命令行中输入这个命令chmod +x hello.sh让这个脚本有可执行权限,再输入./hello.sh验证输出结果

image-20250603105539656

点击上方terminal我们来试一下。已经有权限了,能看到我们已经成功输出了hello world。

image-20250603105600374

第一个脚本已经完成了,我们继续让他修改代码,让它接受一个名字,作为第一个参数,但默认为“world”

image-20250603105620823

还是报错,别担心我们稍等一会

image-20250603105628704

这里提示我已经完成了,现在可以使用一个可选的名字参数运行它,比如Alice,它将输出hello Alice!如果没有提供参数,它就会默认为hello world!

image-20250603105646487

我们打开vscode看到成功多加了一个变量参数,然后我们来测试一下。打开terminal,输入./hello.sh gezi,修改后面参数为gezi。能看到成功输出了,效率还是很高的

image-20250603105716193

4、安装cpolar内网穿透

访问cpolar官网: https://www.cpolar.com 点击免费使用注册一个账号,并下载最新版本的Cpolar。

img

登录成功后,点击下载Cpolar到本地并安装(一路默认安装即可)本教程选择下载Windows版本。

image-20240319175308664

Cpolar安装成功后,在浏览器上访问http://localhost:9200,使用cpolar账号登录,登录后即可看到Cpolar web 配置界面,结下来在web 管理界面配置即可。

img

5、配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道:

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

点击创建:

image-20250603105836981

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

image-20250603105903543

现在就已经成功实现使用cpolar生成的公网地址异地远程访问本地部署的openhands啦!

image-20250603105941105

小结

为了方便演示,我们在上边的操作过程中使用cpolar生成的HTTP公网地址隧道,其公网地址是随机生成的。这种随机地址的优势在于建立速度快,可以立即使用。然而,它的缺点是网址是随机生成,这个地址在24小时内会发生随机变化,更适合于临时使用。

如果有长期使用openhands,或者异地访问与使用其他本地部署的服务的需求,但又不想每天重新配置公网地址,还想让公网地址好看又好记并体验更多功能与更快的带宽,那我推荐大家选择使用固定的二级子域名方式来配置公网地址。

6、配置固定二级子域名公网地址

使用cpolar为其配置二级子域名,该地址为固定地址,不会随机变化。

注意需要将cpolar套餐升级至基础套餐或以上,且每个套餐对应的带宽不一样。【cpolar.cn已备案】

点击左侧的预留,选择保留二级子域名,地区选择china top,然后设置一个二级子域名名称,我这里演示使用的是openhands,大家可以自定义。填写备注信息,点击保留。

image-20250603110035736

保留成功后复制保留的二级子域名地址:

image-20250603110050085

登录cpolar web UI管理界面,点击左侧仪表盘的隧道管理——隧道列表,找到所要配置的隧道openhands,点击右侧的编辑

image-20250603110110237

修改隧道信息,将保留成功的二级子域名配置到隧道中

  • 域名类型:选择二级子域名
  • Sub Domain:填写保留成功的二级子域名
  • 地区: China Top

点击更新

image-20250603110124516

更新完成后,打开在线隧道列表,此时可以看到随机的公网地址已经发生变化,地址名称也变成了保留和固定的二级子域名名称。

image-20250603110144554

最后,我们使用固定的公网地址在任意设备的浏览器中访问,可以看到成功访问本地部署的OpenHands 页面,这样一个永久不会变化的二级子域名公网网址即设置好了。

image-20250603110217266

总结

现在,你不仅有了一个强大的本地编码助手OpenHands,还能通过cpolar远程访问它。无论是办公室、家里还是咖啡馆,随时随地都能轻松编程!是不是觉得未来的日子充满了无限可能呢?赶快行动起来,让OpenHands成为你的得力伙伴吧!

以上就是如何在本地windows系统快速部署OpenHands,并安装cpolar内网穿透工具配置固定不变的二级子域名公网地址,实现随时随地远程访问的全过程,感谢您的观看,有任何问题欢迎留言交流。

总结:在效率至上的开发时代,AI工具与网络穿透技术正在重塑工作模式。通过构建自主可控的智能辅助体系,则让从代码生成到联调测试的全流程效率实现质变——这不是简单的功能叠加,而是为开发者开辟了真正的生产力跃迁通道。

本篇文章知识点来源[cpolar官网][https://www.cpolar.com]

Logo

助力广东及东莞地区开发者,代码托管、在线学习与竞赛、技术交流与分享、资源共享、职业发展,成为松山湖开发者首选的工作与学习平台

更多推荐