发布包
下载对应平台的发布包,校验 sha256 后直接运行;适合 Windows 与不便执行安装脚本的环境。
选择发布包
到 发布页 下载对应平台的压缩包。文件名里的版本号不带 v(如 1.0.0),下载路径里的标签带 v(如 v1.0.0):
| 系统 | amd64 | arm64 |
|---|---|---|
| Linux | imgyoung_<版本号>_linux_amd64.tar.gz | imgyoung_<版本号>_linux_arm64.tar.gz |
| macOS | imgyoung_<版本号>_darwin_amd64.tar.gz(Intel) | imgyoung_<版本号>_darwin_arm64.tar.gz(Apple 芯片) |
| Windows | imgyoung_<版本号>_windows_amd64.zip | imgyoung_<版本号>_windows_arm64.zip |
同目录的 checksums.txt 列出每个包的 sha256。包里的内容:
deploy/ 是 Docker Compose、反向代理与 systemd 的示例配置,web/licenses/ 是管理后台所用第三方代码的许可证。二进制不依赖其他文件,可以单独拷走。
下载与校验
以 1.0.0 为例,换成你要装的版本与架构:
VERSION=1.0.0
FILE=imgyoung_${VERSION}_linux_amd64.tar.gz
BASE=https://github.com/x-haose/imgyoung/releases/download/v${VERSION}
curl -fLO "$BASE/$FILE"
curl -fLO "$BASE/checksums.txt"
grep " $FILE\$" checksums.txt | sha256sum -c -
tar -xzf "$FILE"校验通过时,Linux 与 macOS 输出 <文件名>: OK,PowerShell 不报错;不一致就不要使用这个包,重新下载。
运行
./imgyoung浏览器打开 http://<主机>:8721/,用 admin / imgyoung123 登录,首次登录会要求立即改密。Ctrl+C 优雅停机。
-
数据目录默认是启动时当前目录下的
data/,不是二进制所在的目录;换个目录启动就会得到一个全新的空实例。用IMGYOUNG_DATA_DIR固定位置:IMGYOUNG_DATA_DIR=/srv/imgyoung ./imgyoung$env:IMGYOUNG_DATA_DIR = "D:\imgyoung-data"; .\imgyoung.exe -
监听地址默认
:8721,即所有网卡;只给本机反向代理用时设IMGYOUNG_LISTEN=127.0.0.1:8721。其他环境变量见 配置。 -
查看版本:
./imgyoung -version。这是唯一的命令行参数,其余配置都走环境变量与后台。
Windows 上首次运行时,防火墙可能询问是否允许 imgyoung.exe 访问网络;只在本机使用可以不放行。
交给进程管理器托管
长期运行不要只开在一个终端里。进程管理器负责开机启动、崩溃后拉起;另外,后台「设置 → 备份与导出」里的「恢复」会让服务主动正常退出,靠进程管理器重新拉起时换入快照,没有它恢复就要手动启动才能完成。进程管理器要配置成进程退出后总是重启,包括正常退出。
-
Linux:用包里的 systemd 示例,效果与 一行安装脚本 的
--service相同,数据在/var/lib/imgyoung,各项设置的含义也见那一页:终端 sudo install -m 0755 imgyoung /usr/local/bin/imgyoung sudo install -m 0644 deploy/imgyoung.service /etc/systemd/system/imgyoung.service sudo systemctl daemon-reload sudo systemctl enable --now imgyoung -
macOS:可以写一个 launchd 服务,或者改用 Docker。
-
Windows:用 WinSW、NSSM 等工具把
imgyoung.exe注册为 Windows 服务,设置好工作目录或IMGYOUNG_DATA_DIR,以及退出后重启。
升级
下载新版本的包并校验,停止服务,用新的二进制替换旧的,再启动。数据目录不用动,数据库结构在新版本启动时自动迁移。换回旧的二进制不能降级:旧版本遇到被新版本迁移过的数据库会拒绝启动,回滚要用旧版本加升级前的快照。升级前建议先在后台「设置 → 备份与导出」点「立即备份」,回滚步骤与更多注意事项见 升级。