GeoLibre 桌面端安装教程：Windows、macOS、Linux 三平台完整指南-迪斯科星球

GeoLibre 桌面端安装教程：Windows、macOS、Linux 三平台完整指南

【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibre

GeoLibre 是一款免费开源的云原生 GIS 平台，用于地图可视化、空间数据探索与地理空间分析，内置 1000+ 可在本地运行的空间处理工具。这篇 GeoLibre 桌面端安装教程按平台给你直接可用的命令和最少步骤，照着做一次装好。

先想清楚：你的平台和使用习惯决定安装方式

不用看完全文也能选对。对号入座：

你在 Windows 上？默认去 Microsoft Store 装，签名、自动更新、没有信任弹窗；习惯终端就用 winget。
你在 macOS 上、习惯终端？Homebrew 一条命令装完，升级卸载都同样一条命令。
你在 macOS 上、只想点商店？选 Mac App Store，但它是沙盒版，Python 侧车、PostGIS 等能力被裁掉，重度用户选 Homebrew / DMG。
你在 Arch / Manjaro？AUR 的geolibre-bin二进制包，随系统更新。
你在 Fedora / RHEL？COPR 源两行命令。
你在其他 Linux 发行版？Flatpak 跨发行版通用，或直接下.deb/.rpm/ AppImage。
需要免安装、装进 U 盘、离线部署？选官方安装包或 Windows 便携版。

无论哪种方式，装的都是同一个应用：项目文件（.geolibre.json）在 Web、桌面、移动端之间可以互用。

Windows：GeoLibre 桌面端 Windows 安装方式

结论：普通用户走 Microsoft Store，命令行用户走 winget，特殊场景才用安装包或便携版。

Microsoft Store（默认选择）

在 Microsoft Store 里搜索GeoLibre点安装即可。这是官方推荐的 Windows 渠道：应用经过签名，启动没有 SmartScreen 提示，后续版本由商店自动更新。商店版的打包逻辑可参考 packaging/msix/README.md（注意：该文件在仓库 packaging 目录内）。

winget 一行命令

打开 PowerShell 执行：

winget install OpenGeos.GeoLibre

winget 分发的是 GitHub Release 构建版，功能完整，适合习惯命令行的一键安装。

官方安装包与便携版

安装包：从官方发布页下载.exe/.msi运行即可。该构建未签名，SmartScreen 可能拦截，选「更多信息 → 仍要运行」。
便携版：下载*-x64-portable.zip，解压到任意位置（U 盘也行），双击geolibre-desktop.exe就能跑——不安装、不需要管理员权限、不写注册表。升级就是下载新 zip 覆盖，因为它不自动更新。

macOS：GeoLibre 桌面端 macOS 安装方式

结论：Homebrew 一条命令是 macOS 上最省事的路；DMG 手动装也只需拖拽一步；App Store 版功能有裁剪，按需选择。

Homebrew（一条命令装、升级、卸载）

GeoLibre 已进 Homebrew 官方 Cask 库，无需 tap：

brew install --cask geolibre # 安装 brew upgrade --cask geolibre # 升级 brew uninstall --cask geolibre # 卸载

DMG 构建用 Apple Developer ID 签名并通过公证，Gatekeeper 直接放行，无额外步骤。

DMG 手动安装

下载对应芯片的 DMG（Apple Silicon 选aarch64，Intel 选x64），打开后把GeoLibre Desktop拖入 Applications，再从应用程序里启动。v1.4.1 之后的版本已签名公证，Gatekeeper 放行，无需任何处理。

Mac App Store 沙盒版

在 Mac App Store 搜索GeoLibre Desktop安装即可，像商店应用一样自动更新，不用终端。注意它是沙盒构建，以下能力被裁掉，需要就改用 Homebrew / DMG 版：

Python 侧车引擎（GeoPandas、rasterio、GDAL 转换、SamGeo 分割等）
Add Data → PostgreSQL / PostGIS（martin 瓦片服务）
本地 Jupyter 服务器（商店版 Notebook 面板仅 JupyterLite）
从 zip 或注册表安装外部插件（仅内置与随包插件）

Whitebox 工具箱（1000+ WASM 工具）、SQL 工作区（DuckDB-WASM、PGlite）不受影响，两个版本都完整可用。完整差异见 docs/mac-app-store.md。

Linux：GeoLibre 桌面端 Linux 安装方式

结论：包管理器渠道（AUR / COPR / Flatpak）随系统自动更新，优先于直接下载安装包。

Arch / Manjaro（AUR 二进制包）

geolibre-bin直接打包官方 Release，不需要源码编译：

yay -S geolibre-bin # 或 paru -S geolibre-bin

Fedora / RHEL（COPR）

sudo dnf copr enable giswqs/geolibre sudo dnf install geolibre

RHEL 及衍生版先执行sudo dnf install dnf-plugins-core启用 COPR 插件。

Flatpak（任意发行版，经 FlatPark）

添加一次远端后安装，之后flatpak update随系统更新：

flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo flatpak install flatpark app.geolibre.GeoLibre

官方安装包：.deb / .rpm / AppImage

# Debian / Ubuntu sudo apt install ./GeoLibre.Desktop_<version>_amd64.deb # 其他 RPM 发行版 sudo dnf install ./GeoLibre.Desktop-<version>-1.x86_64.rpm # AppImage（任意发行版） chmod +x GeoLibre.Desktop_<version>_amd64.AppImage ./GeoLibre.Desktop_<version>_amd64.AppImage

AppImage 从 v2.3.0 起内嵌更新信息，配合.zsync文件可做增量更新，只下载变化块；.deb/.rpm则靠重新下载新版覆盖安装。

装好后的验证与常见问题

✅验证：启动应用，看到地图主界面、图层面板与样式面板即成功。建一个项目另存为.geolibre.json，它可以直接在 Web 版和移动端打开，跨端互通。

高频安装后问题，按「现象 → 一行解决」处理：

现象：Windows 便携版双击没反应→ 解决：装 WebView2 Evergreen 运行时（Windows 11 与较新 10 已预装，一般用不上）。
现象：Windows 安装包被 SmartScreen 拦截→ 解决：点「更多信息 → 仍要运行」，Release 构建本就未签名，属正常提示。
现象：Linux AppImage 报 FUSE 相关错误→ 解决：sudo apt install libfuse2，或改用./GeoLibre.Desktop_xxx.AppImage --appimage-extract-and-run运行。
现象：旧版 macOS（v1.4.0 及更早）双击打不开→ 解决：执行一次xattr -dr com.apple.quarantine "/Applications/GeoLibre Desktop.app"；v1.4.1+ 已签名公证，不需要这步。
现象：.deb / .rpm 版没有自动更新→ 解决：重新下载新版安装包覆盖安装；AppImage 可用.zsync增量更新。

企业官网建设流程全解析