跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Shell / BashAI算法

LocalAI 本地部署及 CPolar 远程访问实战

LocalAI 是一款开源本地 AI 服务,支持 CPU/GPU 推理并兼容 OpenAI API。演示通过 Docker 在 Ubuntu 上部署 LocalAI,利用 CPolar 内网穿透实现公网远程访问。涵盖容器启动、模型安装、Web UI 交互及固定域名配置步骤,帮助开发者构建离线且安全的私有化 AI 环境,避免数据上传风险。

孤勇者发布于 2026/3/16更新于 2026/4/263 浏览
LocalAI 本地部署及 CPolar 远程访问实战

前言

当处理敏感数据时,将模型部署在本地是保障隐私的最佳方案。LocalAI 是一款开源工具,支持 Llama、Phi 等大模型直接在本地运行,全程不上传数据,且完美兼容 OpenAI API。它特别适合需要离线工作的科研人员或对数据主权有要求的开发者。其 CPU 推理能力甚至能在普通笔记本上流畅运行 7B 模型。

不过,本地部署通常受限于局域网。为了打破这一限制,我们可以结合 CPolar 内网穿透工具,实现安全的远程访问。下面将详细介绍如何在 Ubuntu 系统上通过 Docker 部署 LocalAI,并配置固定公网地址以实现随时随地的调用。

Docker 部署

本例基于 Ubuntu 22.04 环境演示。确保已安装 Docker,若未安装可参考官方文档进行配置。

启动容器后,执行以下命令即可初始化 LocalAI。这里使用的是仅依赖 CPU 的镜像,适合大多数场景:

sudo docker run -ti --name local-ai -p 8080:8080 localai/localai:latest-cpu 

如果服务器配备 NVIDIA 显卡,可以使用支持 GPU 加速的镜像以获得更好的性能:

sudo docker run -ti --name local-ai -p 8080:8080 --gpus all localai/localai:latest-gpu-nvidia-cuda-12 

更多项目配置与使用详情,建议查阅 GitHub 主页获取最新信息。

简单使用演示

容器启动成功后,在浏览器访问 http://localhost:8080 即可打开 LocalAI 的 Web UI 页面。

image-20250107150311522

初次进入页面会提示尚未添加大模型。点击 Gallery 按钮,可以在跳转页面中选择所需的模型。该界面提供了 600 多个大模型,支持按用途标签(如文字转语音、图片生成等)筛选,也可通过搜索框查找特定模型。

image-20250107151137003

以添加 llama-3.2-1b 模型为例,点击 Install 按钮等待安装完成即可。

image-20250107151337786

image-20250107151539442

image-20250107151705300

安装完成后,点击导航栏中的 HOME 返回主页,即可看到刚刚添加的 llama-3.2 模型。

image-20250107153151174

点击导航栏中的 Chat 即可开始对话。右侧模型选择下拉框中会显示已安装的大模型列表。

image-20250107153311605

image-20250107153543150

如需继续安装其他模型,可点击 Models 入口跳转至模型库页面。

image-20250107153714760

安装 CPolar 内网穿透

目前 LocalAI 仅在局域网内可用。若需从外部网络(如手机、平板或异地电脑)访问,可使用 CPolar 内网穿透工具。无需公网 IP,也无需复杂的路由器设置。

一键脚本安装命令如下:

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

img

安装完成后,执行以下命令查看服务状态,确认正常启动:

sudo systemctl status cpolar 

img

服务启动后,在浏览器输入 http://localhost:9200 访问 CPolar 管理界面,使用官网账号登录后即可进行配置。

image-20240801133735424

配置公网地址

登录 CPolar Web UI 后,点击左侧隧道管理创建新隧道:

  • 隧道名称:自定义,例如 localai,注意不要与已有隧道重复
  • 协议:http
  • 本地地址:8080
  • 域名类型:随机域名
  • 地区:China Top

点击创建后,在线隧道列表会生成两个公网地址。此时即可在其他设备或移动端通过任意一个地址访问本地部署的 LocalAI。

image-20250107155748353

image-20250107160010472

成功连接后,即可在异地浏览器中使用 AI 大模型聊天。

image-20250107160149458

说明:随机生成的公网地址建立速度快,但 24 小时内可能变化,适合临时测试。若需长期使用,建议配置固定二级子域名。

配置固定公网地址

为获得稳定的访问地址,可配置固定二级子域名。此功能通常需要升级至基础套餐或以上。

点击左侧预留,选择保留二级子域名,地区选 China Top,设置名称(如 mylocal),填写备注后点击保留。

image-20250107160432921

保留成功后复制域名地址,回到隧道管理列表,找到 localai 隧道点击编辑。

image-20250107160552136

修改隧道信息:

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

点击更新。

image-20250107160647570

更新完成后,隧道列表中的地址将变更为固定的二级子域名。使用新地址访问,即可永久保持连接不变。

image-20250107160726385

至此,已在本地 Ubuntu 系统通过 Docker 部署 LocalAI,并结合 CPolar 实现了固定公网地址的远程访问。整个过程无需高昂的 GPU 成本,即可构建安全、离线的私有化 AI 环境。

目录

  1. 前言
  2. Docker 部署
  3. 简单使用演示
  4. 安装 CPolar 内网穿透
  5. 配置公网地址
  6. 配置固定公网地址
  • 💰 8折买阿里云服务器限时8折了解详情
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • AI 产品经理转型指南:从传统产品到智能产品的进阶路径
  • Stable Diffusion 显存释放指南:解决内存不足问题
  • Android MVVM 架构实战:DataBinding 中 BindingAdapter 的使用与原理
  • Unity 5.2.0 引擎核心功能、图形渲染与性能优化指南
  • AI 产品经理入门指南:核心职责与技能路线
  • Spring AI Alibaba 快速入门与核心功能解析
  • AI 大模型与 Agent 重塑医疗行业:智能诊疗助手项目实战
  • DeepSeek 浪潮下,前端开发的变革与实战指南
  • HarmonyOS Next DevEco Studio 端云一体化开发业务介绍
  • OpenAI COO 访谈:大模型时代企业如何落地应用
  • 基于 SpringBoot 的协同过滤话题推荐系统设计与实现
  • Ansible 常用模块详解:replace 模块用法
  • macOS 清理:用免费开源工具 Pearcleaner 彻底卸载应用
  • OpenCode 开源 AI 编码代理工具完全指南
  • C++ 毕业设计项目效率提升实战:从冗余代码到高性能架构
  • VSCode 连接 GitHub 全攻略:上传与克隆代码操作指南
  • GLM-4v-9b 实战:基于 llama.cpp GGUF 在消费级 GPU 部署多模态模型
  • AI 驱动下 Playwright 结合 RobotFramework 的 Web UI 自动化测试
  • OpenClaw 配置本地 Ollama 模型指南:打造全离线个人 AI 助理
  • 谷歌 Gemini 的 6 种免费使用渠道与方法指南

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online