Map Blueprint

在你自己的电脑上运行 Map Blueprint

只需几分钟，就能让这款应用在你自己的电脑上跑起来，非常适合一个人，或同一网络中的一个团队。无需安装任何东西，也无需编辑任何文件：Map Blueprint 就是一个你下载下来、双击即可运行的单一程序，和其他应用一样。

开始之前： 把你下载的文件解压到任意你喜欢的位置（例如在「文档」里新建一个 MapBlueprint 文件夹）。里面针对每种电脑都有一个程序，用与你电脑匹配的那个（Windows、Mac 或 Linux），其余的忽略即可。想让身处异地的队友通过互联网访问？那就改用云端托管指南。
运行它时实际发生了什么？ 两样东西会一起启动：一个小型后台程序（称为服务器），它负责存储你的地图并让其他人连接进来；以及你的网页浏览器，它会打开这款应用。只要服务器在运行，应用就能用。关闭它就会停止应用，你保存的地图会安然无恙地留在你的硬盘上。

Windows

1. 启动应用

双击 MapBlueprint.exe。会弹出一个黑色的小控制台窗口，那是服务器在工作，让它开着就好。随后你的浏览器会自动打开这款应用。

第一次运行时，Windows 可能会弹出一个蓝色的「Windows 已保护你的电脑」提示框，因为这款应用并非来自知名发行商。点击更多信息 → 仍要运行。这对小型独立应用来说很常见，也是安全的，只是因为应用没有做代码签名而已。

2. 设置密码

第一次运行时，你会看到一个简短的设置界面。选一个团队登录时要用的密码（如果这是只有你自己使用的私人电脑，也可以留空），然后点击保存，整个设置就完成了。

3. 开始绘制地图

你会进入地图面板。创建一张地图，把链接分享给同网络内的队友。日后想停止应用，关闭控制台窗口即可；想再次启动，双击程序就行。

Mac

MapBlueprint-mac 可在任何 Mac 上运行，既支持 Apple Silicon（M1/M2/M3/M4），也支持较旧的 Intel Mac。在 Apple Silicon 上，macOS 第一次可能会提示安装 Rosetta，点击安装（这是 Apple 提供的一键组件，可让应用运行起来）。

1. 第一次打开它

对于不是来自 App Store 的应用，macOS 在你第一次打开时会拦截它。要跳过这一次拦截：右键点击（或按住 Control 再点击）程序 → 打开 → 在弹出的对话框中再次打开。这第一次之后，你就可以像其他应用一样直接双击它了。

熟悉终端（Mac 的文本命令应用）吗？你也可以在存放程序的文件夹里运行下面三行命令来完成同样的事。第一行清除「从互联网下载」的标记，第二行把文件标记为可运行，第三行启动它：

xattr -d com.apple.quarantine ./MapBlueprint-mac
chmod +x ./MapBlueprint-mac
./MapBlueprint-mac

2. 设置密码并开始绘制

你的浏览器会打开首次运行的设置界面。选一个密码（或留空）并保存，你就可以开始绘制了。一个设置文件（config.json）和你的地图会被创建在程序旁边。

Linux 桌面

在存放程序的文件夹里打开一个终端。第一条命令把文件标记为可运行，第二条启动它。随后你的浏览器会打开「设置」界面。

chmod +x ./map-blueprint-linux
./map-blueprint-linux

想要一个常开的 Linux 服务器，让远程队友也能访问？那就改用云端托管指南。

随时更改设置

打开应用，进入你的地图页面，点击设置。在那里你可以更改名称、颜色、徽标、密码、端口和团队规模，无需编辑任何文件。外观相关的更改会在下次刷新后生效；密码和端口的更改会在你重启程序后生效。

把密码留空会运行一个无需登录的开放实例。只在你信任并掌控的私人网络中才这样做。

你的数据与备份

在你的局域网内共享

要让同一个 Wi-Fi 或办公网络中的队友打开你的地图，你得先告诉应用接受来自其他电脑的连接，默认情况下它只监听你自己这台电脑。打开设置，把绑定地址设为 0.0.0.0（用大白话说就是「接受我网络里任何电脑的连接」），然后重启程序。队友随后即可通过 http://YOUR-COMPUTER-IP:8080 访问你。

要查找你电脑的局域网 IP 地址（一串类似 192.168.1.42 的数字），在终端里运行下面其中一条命令：

请先在「设置」里设一个密码，否则网络中任何拿到链接的人都能打开你的地图。

让远程队友进入，一个免费的隧道

想让网络之外的人访问应用，同时它仍运行在你自己的电脑上？隧道是一个小型助手，它会给你的应用一个公开的 https://… 网址，无需改动路由器，加密，且免费。最简单的是 Cloudflare Tunnel。

请先设置密码。 在开启隧道之前，先打开设置选一个强密码，隧道一旦上线，任何拿到链接的人都能访问应用。

1. 安装 cloudflared

cloudflared 是 Cloudflare 的免费隧道工具。你只需安装一次：

2. 启动 Map Blueprint

像往常一样运行应用并让它开着，它正在 http://localhost:8080 上监听（localhost 就是指「这台电脑」）。绑定地址可以保持默认；隧道就在你这台机器上访问应用。

3. 开启隧道

打开一个新的终端或 PowerShell 窗口（让应用在它自己的窗口里继续运行），然后运行：

cloudflared tunnel --url http://localhost:8080

稍等片刻，它会打印出一个类似 https://random-words.trycloudflare.com 的公开网址。把这个链接分享出去，队友可以从任何地方打开它，用你的密码登录，并与你实时一起编辑。请让两个窗口都开着（应用窗口和隧道窗口）；关闭隧道窗口会停止共享。

这个快速隧道无需 Cloudflare 账户，但每次重启网址都会变。想要在你自己的域名上获得固定网址，可以注册一个免费的 Cloudflare 账户并设置一个命名隧道，云端托管指南展示了同样的 cloudflared 设置，而且指向你本地电脑时用法完全相同。想要一个始终在线的实例，哪怕你的电脑关机时也在线，就把它运行在一台小型云服务器上。