搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

TouchWorkStation/omarchy-server

运维与部署

把一台 Omarchy 机器变成可在任意浏览器中管理的家庭服务器,自托管应用、文件、虚拟机和远程桌面都集中在一处。

114
8
JavaScript
MIT
创建于 5 天前

项目介绍

Omarchy Server 把一台现有的 Omarchy 机器(Arch Linux + Hyprland)变成家庭服务器,所有操作都在浏览器里完成。它提供约 580 个自托管应用的应用商店、基于真实主目录的文件浏览、libvirt 虚拟机、网页终端、存储池(Btrfs,可选 ZFS)以及连接服务器本机 Omarchy 桌面的远程访问。界面会按手机、平板和电脑切换布局,桌面主题、壁纸、Dock 等设置按账号保存。

整体分为三部分:omarchyd 以当前用户身份监听 127.0.0.1:2021,负责账户、文件、应用、虚拟机和存储;omarchy-server-web 在 7780 端口提供网页界面;一个小型 root helper 通过一条 sudoers 规则处理存储池、SMB 共享、防火墙端口和电源操作。应用运行在 rootless Podman 中,端口只允许已登录的浏览器访问,安装脚本在无网络的沙箱里执行。

快速使用

前提:一台已装好 Omarchy 的 x86-64 机器、安装期间可联网;需要快速虚拟机时准备 /dev/kvm,要新建存储池则准备空白硬盘。

  1. 在服务器上用普通用户(不要用 sudo)执行安装脚本:

    curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bash
    
  2. 脚本会安装缺失依赖(Node.js、Podman、libvirt、wayvnc 等),把项目构建到 ~/.local/share/omarchy-server,在终端里让你创建账户,并启动两个登出后仍运行的系统级用户服务。需要 ZFS 时加 --zfs。

  3. 在浏览器打开 http://<服务器 IP>:7780(或 https 地址)并登录。

  4. 再次执行同一命令或在 Settings → Software update 中更新;omarchy-server uninstall 卸载软件但保留账户、应用和虚拟机,加 --purge 会一并删除。

日志可用 journalctl --user -u omarchyd -u omarchy-server-web -f 查看。开发流程为 npm install、npm run build、npm test。

使用约束

  • 服务端必须运行 Omarchy,应用商店不面向任意 Linux 发行版。
  • 虚拟机以当前用户身份运行在 libvirt 的用户会话中;有 KVM 才全速,没有也能运行但较慢。
  • SMB 共享只在家庭局域网地址上开放;Tailscale 被视为第二网络,不会获得 445 端口。
  • Local swarm 连接器支持带 systemd 的多种 Linux 发行版,但桌面共享只支持 Hyprland、Sway 等 wlroots 桌面(wayvnc)或 X11(x11vnc);GNOME 和 KDE 的 Wayland 会话目前不能共享,需要改用 X11 会话。
  • 存储池只在空白硬盘上创建,因此不会擦除已有数据的硬盘。
  • 项目独立于 Omarchy,与 Omarchy 官方无隶属关系。许可证为 MIT。

HotRepo 点评

Omarchy Server 还是新项目,尚未记录到 GitHub 全语言日榜名次。在 2026-11-17 的 JavaScript 新项目榜中,它记录到 114 Star、8 Fork,并在约一个半小时的统计窗口内净增 10 Star。这只能说明早期有关注,还不足以判断采用情况。更值得关注的是覆盖面:它把应用托管、按用户隔离的虚拟机、真实桌面远程控制和 NAS 式存储放进同一个浏览器界面,并用 rootless Podman、应用端口仅限已登录浏览器、屏幕走一次性票据等默认设置处理了家庭服务器对外暴露时的隔离问题。

项目源码与说明

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. typecraft-dev/oma-cast给 Omarchy 用户的键盘启动器,按使用习惯给应用和 Omarchy 命令排序。JavaScript418
  2. piermark/omarchytv把客厅电视换成类 Omarchy 平铺桌面式主界面,支持 Android/Google TV,webOS 仍属试验。Java121
  3. prusa3d/prusa-connect在自有网络里自托管运行、管理和监控 3D 打印机机群的 Go 服务端。Go100
  4. traccar/traccar自托管的 GPS 追踪平台,用 200+ 设备协议把车队、资产或个人定位器汇总到一个看板和 API。Java7,972
  5. IceWhaleTech/CasaOS把家用服务器变成个人云:用网页界面安装 Docker 应用、管理文件与磁盘。Go37,456