Skip to content

JumpServer Desktop v0.1.6

Choose a tag to compare

View all tags
@github-actions github-actions released this 17 Sep 02:24
v0.1.6
941d1cf

中文

自动发现新版，由你决定何时安装

v0.1.6 完善桌面端自动更新：后台检查、可选自动下载、清晰的更新入口，同时保留安装前确认，避免更新打断运维工作。更新源继续使用本仓库 GitHub Releases，不需要额外配置更新服务器。

本次更新

  • 自动检查默认开启：启动并加载设备设置 15 秒后首次检查，此后每轮后台检查结束 6 小时后再次检查。只获取正式稳定版本；开发模式不会访问更新服务。
  • 自动下载默认关闭：Windows NSIS 和 Linux AppImage 可在“设置 → 关于与更新”中开启。发现新版后后台下载；已有可用新版时，保存开启设置会立即开始下载。关闭选项不会取消已开始的下载。
  • 更新入口常驻顶部：发现新版或下载完成时显示版本，点击进入设置查看更新说明或安装，不会关闭当前连接。
  • 安装始终由用户确认：下载完成后选择“重启并安装”；不强制重启，也不在普通退出时自动安装。连接、传输和未保存编辑仍有退出确认；设置有未保存草稿时禁止安装。
  • 偏好跨登录保留：检查与下载选项通过“保存并应用”保存为设备设置。旧版设置自动补齐新字段，保留已有字体、语言等配置。关闭自动检查后仍可手动检查。
  • 后台失败不打断工作：错误和进度在设置页显示，支持手动重试；离线不会误报为最新版。并发检查合并，迟到的命令回复不会覆盖新的下载状态。
  • 更新控件、全局入口和安装提示均提供中英文，适配紧凑窗口。

从旧版升级

  • Windows x64 / Linux AppImage：在旧版“设置 → 关于与更新”中手动检查、下载并确认安装 v0.1.6；本次新增的后台检查策略在升级后生效。
  • Linux .deb：下载新版后通过系统包管理器安装。
  • macOS Apple Silicon / Intel：下载对应 arm64 / x64 安装包，退出应用后手动替换 /Applications/JumpServer Desktop.app。macOS 和 .deb 可检查新版，但当前不提供应用内自动下载或安装。

macOS 手动安装与隔离提示

所有平台安装包均未签名；macOS 也未公证。 先从本仓库正式 Release 下载，并将安装包 SHA-256 与附件 SHA256SUMS 核对。校验和可检测下载损坏，但不能替代发行者签名。

如果将应用复制到“应用程序”后仍因隔离属性被 macOS 拦截，在确认来源、校验值和组织安全策略允许后，可在终端手动执行以下命令。工具名是 xattr，不是 xttr：

xattr -dr com.apple.quarantine "/Applications/JumpServer Desktop.app"

该命令仅移除此应用及其内部文件的隔离属性，不等于获得 Apple 信任，也不会为应用签名或公证。不要对整个 /Applications 或下载目录执行，不要关闭全局 Gatekeeper。若提示权限不足，先检查安装位置与文件权限，不要直接改用 sudo；组织禁止未签名应用时请停止安装。应用与 README 提供相同说明，界面只显示／复制命令，绝不会代为执行。

验证

  • 本地类型检查、生产构建和 127 项测试通过。
  • 使用真实 electron-updater 与隔离的本地更新源，验证定时检查、SHA-512 校验下载，以及下载完成后等待明确安装操作；未执行真实安装替换。
  • 已验证实际桌面 IPC 设置持久化，以及中英文界面的保存失败保护、迟到响应、全局更新入口和 macOS 紧凑布局。
  • 发布流水线对 Windows、Linux、macOS 进行验证、打包、打包后启动与 IPC 冒烟检查，完整产物校验通过后才公开发布。

本项目为非官方社区项目，与 JumpServer 官方没有隶属或背书关系。

English

Discover updates automatically. Install when you choose.

v0.1.6 adds background update checks, optional automatic downloads, and a persistent update entry while keeping installation under your control. Updates continue to come from this repository's GitHub Releases; no additional update server configuration is required.

What's new

  • Automatic checks are enabled by default: the first check runs 15 seconds after startup settings load, then 6 hours after each scheduled check finishes. Only stable releases are considered; development mode does not contact the update service.
  • Automatic downloads are opt-in: Windows NSIS and Linux AppImage users can enable them under Settings → About and updates. New versions download in the background; enabling and saving the preference starts a download immediately if an update is already available. Turning it off does not cancel an active download.
  • Persistent update entry: the window header shows available or downloaded updates and opens Settings for release notes or installation without closing existing connections.
  • Installation always requires confirmation: select “Restart and install” after downloading. Updates never force a restart or install on normal quit. Exit confirmation still protects connections, transfers, and unsaved edits; unsaved settings block installation.
  • Preferences survive login changes: use “Save and apply” to persist device-wide update choices. Existing settings are migrated without resetting fonts, language, or other preferences. Manual checks remain available when automatic checks are disabled.
  • Quiet background failures: errors and download progress remain visible in Settings with manual retry; offline errors are not reported as “up to date.” Concurrent checks are coalesced, and late command replies cannot overwrite newer download state.
  • Update controls, the global entry, and installation guidance are available in Chinese and English, including compact-window layouts.

Upgrading from an earlier version

  • Windows x64 / Linux AppImage: use the previous version's Settings → About and updates to manually check, download, and confirm installation of v0.1.6. The new background-check policy takes effect after upgrading.
  • Linux .deb: download the new package and install it using your system package manager.
  • macOS Apple Silicon / Intel: choose the matching arm64 / x64 package, quit the app, and manually replace /Applications/JumpServer Desktop.app. macOS and .deb installations can check for updates but currently do not download or install them automatically within the app.

macOS manual installation and quarantine

All platform artifacts are unsigned; macOS builds are also not notarized. Download from this repository's official Release and compare the installer's SHA-256 with the attached SHA256SUMS. Checksums detect corruption but do not replace publisher signatures.

If macOS still blocks the app because of quarantine after copying it to Applications, and you have verified the source, checksum, and your organization's security policy, you may manually run the following command in Terminal. The command is xattr, not xttr:

xattr -dr com.apple.quarantine "/Applications/JumpServer Desktop.app"

This removes quarantine only from this app and its contents; it does not sign, notarize, or make the app Apple-trusted. Never target the entire Applications/downloads directory or disable Gatekeeper globally. If permission is denied, check the installation location and file permissions rather than immediately using sudo. Do not install if your organization prohibits unsigned applications. The app and README provide the same guidance; the interface only displays/copies the command and never executes it.

Verification

  • Local type checks, the production build, and all 127 tests passed.
  • A real electron-updater smoke run against an isolated local feed verified scheduled checks, a SHA-512-verified download, and waiting for explicit installation. No actual installed application was replaced.
  • Verified real desktop IPC preference persistence plus Chinese/English UI handling for failed saves, late replies, the global update entry, and compact macOS guidance.
  • The release pipeline verifies and packages Windows, Linux, and macOS, runs packaged startup/IPC smoke checks, and validates the complete artifact set before publication.

This is an unofficial community project, not affiliated with or endorsed by JumpServer.

完整变更 / Full changelog: v0.1.5...v0.1.6

Assets 19
Loading