AFFiNE 是一款开源的、集知识库、文档编辑与白板功能于一体的工作空间工具，它支持块状编辑、数据表格、画板绘制以及灵活的视图切换，所有内容均基于本地优先原则存储，用户可完全掌控数据，非常适合需要高度定制化与隐私保护的个人或团队用于知识管理、项目协作与创意构思。

本文将详细介绍如何在自己本地局域网内部署 AFFiNE ，并结合nat123端口映射简单实现让外网访问内网内部署的AFFiNE，无公网IP环境内部项目提供互联网远程访问等场景同理可参考这种方案。

访问 AFFiNE 官方网站的下载页面：https://affine.pro/download 或其 GitHub Release 页面。

（一）Windows 安装（普通用户推荐）

双击运行安装程序，按照提示完成安装。通常是标准的 Windows 应用安装流程。

下载 .dmg 文件 (Intel 或 Apple Silicon 版本)。

将 AFFiNE 应用图标拖拽到“应用程序”(Applications) 文件夹中。

首次打开可能需要安全确认（系统偏好设置 -> 安全性与隐私）。

对于 .AppImage：下载文件后，给予执行权限 (chmod +x AFFiNE-*.AppImage)，然后直接运行 (./AFFiNE-*.AppImage)。

对于 .deb 包：下载后使用包管理器安装 (如 sudo dpkg -i AFFiNE-*.deb，可能需要 sudo apt --fix-broken install 解决依赖)。

适合需要将 AFFiNE 部署在自己服务器上的用户。具体命令可能随版本更新，请以官方文档为准。确保本地服务器已安装Docker 和 Docker Compose是前提条件。

1，安装Docker。本教程操作环境为 Linux Ubuntu 系统，AFFiNE 依赖 Docker 运行，我们需要先确保你的系统上已经安装了 Docker 。

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep -Po '"tag_name": "\K.*\d')" /usr/local/bin/docker-compose

4，下载官方最新的 docker-compose.yml 和环境变量配置文件 .env 。

wget -O docker-compose.yml https://github.com/toeverything/affine/releases/latest/download/docker-compose.yml

wget -O .env https://github.com/toeverything/affine/releases/latest/download/default.env.example

5，修改环境变量配置文件 .env ，设置数据库密码 DB_PASSWORD 。

7，打开浏览器访问地址 http://你的服务器 IP:3010 ，就能看到你部署的 AFFiNE 登录界面了。

内网穿透或内网端口映射软件方法均可以实现。这里示例安装nat123内网映射的通用方案，将本地无公网下的设备和项目网址绑定自定义公网域名端口地址，我是windows环境普通用户可参考，如是Linux或android来安装部署的同理但注意下运行客户端后在对应官网管理后台进行操作设置即可。

需要先在任意一台 Windows或其他机器安装nat123客户端，用作跨网穿透映射管理。

登录nat123客户端在客户端主界面，进入“映射 ”列表，点击下角的“ 添加映射 ”，此时可查看到对应的编辑映射界面，此设置用于将内部设备或应用添加绑定到对应外部地址下。

添加映射时的几个主要信息参考：

类型：选择【非80网站】带端口访问。或用【80http】或【443https】对应外部固定80/443访问，注意如使用443https类型的先确保本地应用本身使用了https协议。

内网地址端口：在内网地址填写你的服务器 IP ，本机的用127或localhost；内网端口就是AFFiNE 端口 3010 （以本地自己应用实际使用端口填写）。

外网地址端口：自动生成可用，如是新手测试可以不用改；如有自己域名，也可以修改使用自己注册的域名。

确认保存信息创建好后，就可以看到一条映射的信息图标，同时有显示对应的内网ip端口地址和公网域名端口地址，鼠标移动放上去会一些提示参考下方便排除问题。需要注意的是，因为映射客户端区分前端和后台服务程序 ，映射服务后台程序默认开机就会自动启动，重启机子后也不需要再登录手动启动了。

在外网电脑上，打开浏览器，在地址栏输入从内部nat123映射设置好的外网地址，就可以看到内网部署的 AFFiNE 登录界面了。

开源AFFiNE协同知识库工作空间本地部署，并实现无公网IP让外部远程访问编辑查看数据

开发工具

网络与通信

AFFiNE是一款开源知识库与协作工具，支持本地部署，适合团队进行知识管理和远程协作。本文详细介绍如何在局域网内安装AFFiNE，并利用nat123端口映射实现外网访问，无需公网IP即可远程访问内网项目，适合Windows、macOS、Linux及Docker环境部署。

包管理器

数据库

服务器

Windows

Docker

Linux

2026年中大促 | AI 领航 智绘未来

热销域名限时优惠，新客首年免费！


domain

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

开源AFFiNE协同知识库工作空间本地部署，并实现无公网IP让外部远程访问编辑查看数据

开源AFFiNE协同知识库工作空间本地部署，并实现无公网IP让外部远程访问编辑查看数据

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐