## 拜托各位决定升级前好好看看下面更新内容和升级步骤，以及注意事项。详情查看：https://github.com/halo-dev/halo/releases/tag/v1.3.0 更新教程：https://halo.run/archives/install-with-linux.html#%E6%9B%B4%E6%96%B0-halo 下面是 1.3.0 版本所有更新内容： ## Feature - 支持设置文章链接风格（默认，日期型，年月型，ID型）。#563 - 支持设置文章后缀（可实现伪静态）。#563 - 新增磁盘缓存方式。#494 - 支持设置全局路径类型（绝对路径，相对路径）。 - 支持主题设置最低兼容版本。#544 - 支持分类目录和标签设置封面图。#574 - 归档页面支持分页。#608 - 支持数据导入导出功能，方便 H2 与 MySQL 之间无缝迁移。需要注意的是，为了防止误操作，仅仅在博客初始化的时候才能导入数据。#687 - 支持主题开发者自定义邮件发送模板。#691 - 支持分类订阅，`/feed/categories/{slugName}.xml` or `/atom/categories/{slugName}.xml`。#595 - 支持在主题中自定义邮件发送模板。#691 ## Change - 修改邮件发送的文案，防止被服务商判定为广告邮件导致封号。#568 - 取消后台更新 admin 的功能。 - admin 的大部分资源使用 jsdelivr cdn 代理。 - 修改初始化数据，新增更多页面类型。#600 - 优化启动日志，高亮访问地址。#634 - 优化上传文件过程中，内存消耗过大的问题。#659 @bestsort - 部分核心依赖升级。 - 升级 Markdown 解析器版本。#695 - 在初始化页面中，移除 0.x 迁移的功能，替换为数据导入功能。#633 - 将文章设置的密码框放置于高级设置中。 ## Fixed - 修复附件偶发上传失败的问题。#581 - 修复全站备份失败的问题。 - 修复更新主题不触发缓存更新的问题。#553 - 修复后台开发者选项中实时日志顺序有误的问题。#556 - 修复邮件发送的部分问题。#584 - 修复 sm.ms 无法上传的问题。#609 - 修复 RSS 包含某些特殊符号时，无法正常访问的问题。#641 - 修复某些 SQL 语句在 MySQL 中无法正常执行的问题。 - 评论框 XSS 修复。#677 - 修复文章设置中，标签选中后无法触发保存的问题。 - 修复文章数量显示不准确的问题。#705 - 修复在 iOS 浏览器中，菜单闪烁的问题。 ## 升级步骤 1. 由于这个版本修改了大量的主题 API，导致无法兼容旧版本主题，所以升级前请确保你正在使用的主题已经适配了 1.3.0。 2. 备份数据：`cp -r ~/.halo ~/.halo.bak`。 3. 重命名（备份）旧运行包：`mv halo-latest.jar halo-latest.jar.bak`。 4. 下载新运行包：`wget https://dl.halo.run/release/halo-1.3.0.jar -O halo-latest.jar`。 5. 测试是否能够正常启动：`java -jar halo-latest.jar`。 6. 重启：`service halo restart`。 7. 更新主题。 ## 注意事项 1. 请务必确保你正在使用的主题已经适配了 1.3.0 再进行更新。目前在 `https://github.com/halo-dev` 下的主题均已适配 1.3.0。 2. 更新前不要忘了备份数据，不管你是以什么方式部署的，都请备份 `~/.halo`，当然，如果你使用 docker 部署，并修改了映射路径的话，就备份你的映射路径。 3. 如果有使用 CDN 全站加速，请更新完毕后，刷新全站缓存，并清空浏览器缓存。 ## 后期计划我们计划这个版本发布之后，在短期内都不会再进行较大功能的开发，我们将在后面很长一段时间内做好这些事情： - 基础建设（主题和评论模块）。 - 完善文档（主要为开发文档）。 - 对已有功能进行改进（编辑器等）和 bug 修复。 - 重构部分代码。 - 安全性。 - 运行包体积优化。 - 资源消耗。所以，未来我们可能会频繁的发布小版本（至少比以前频繁），勿怪。主要是防止一味地更新功能，而没有照顾到其他更应该照顾的地方。如有其他功能的需要，请去 Github 提 issue 以做记录，我们等到 Halo 更加成熟稳定之后，再做打算。 ## 强调一下目前有人反馈，无法从旧版本直接升级到 1.3.0，也就是不能跨版本升级。那么如果你当前版本不是 1.2.0 的话，建议先升级到 1.2.0，再升级到 1.3.0。这个问题我们后面想办法处理一下，考虑移除数据库版本迁移工具。 ## 再强调一下由于 1.2.0 之前的版本有一个严重的安全漏洞，所以建议所有人尽快更新到 1.3.0。

如果你使用的 MySQL，升级到 1.3.0 报错，可以查看一下：https://github.com/halo-dev/halo/issues/715

Halo 1.3.0 发布

xiaofsu

加油！奥里给！

CodeLunatic

已经成功升级，一定要等待程序启动成功再进行其他操作，不然数据丢失了，花了一个小时才解决。

Damon-Yo

棒

Ryan Wang 👍

如果你使用的 MySQL，升级到 1.3.0 报错，可以查看一下：halo-dev/halo715

Ryan Wang 👍

另外一点，请不要去后台的关于更新版本，那个仅仅会更新 admin 的版本。最终你会因为 admin 和后端的版本不一致而导致错误。正确的方式：https://halo.run/archives/install-with-linux.html#%E6%9B%B4%E6%96%B0-halo

在新的版本已经移除了 admin 更新的功能以及版本显示，因为我们认为这个一个极易误导的功能。以后 admin 与 Halo 本身会成为一个整体，也就是同步更新。你无需再做任何操作。更新 Halo 只需要替换一个 jar。

Ryan Wang 👍

Ryan Wang 👍 另外一点，请不要去后台的关于更新版本，那个仅仅会更新 admin 的版本。最终你会因为 admin 和后端的版本不一致而导致错误。正确的方式：https://halo.run/archives/install-with-linux.html#%E6%9B%B4%E6%96%B0-halo

在新的版本已经移除了 admin 更新的功能以及版本显示，因为我们认为这个一个极易误导的功能。以后 admin 与 Halo 本身会成为一个整体，也就是同步更新。你无需再做任何操作。更新 Halo 只需要替换一个 jar。

theboyaply

ChannD

这就发布了啊, 好快啊! 正好, 我的又无法上传东西, 网络错误了. 正好更新重启下!

congjinruo

先OB几天，等空下来再迁移一手。还是非常感谢楼主各种给力优化和不断更新，让我等在互联网上有个属于自己的小窝，舒服啊。

xbk2000

奥利给！！！halo真的太棒了！！！

theboyaply

我用docker部署的，原版本：1.2.0：系统 -> 关于（提示更新） -> 在线更新（更新失败） -> 刷新页面 -> 现在一进后台这个API就报错：

POST：{域名}/api/admin/options/map_view/keys -> Status Code：405 Methoc Not Allowed

docker 日志：

WARN 6 --- [ XNIO-1 task-1] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.HttpRequestMethodNotSupportedException: Request method 'POST' not supported]

麻烦大佬们帮我们看看咋解决这个问题，同时我现在要怎么更新 halo 的版本（后台已经没有在线更新这个按钮了）

theboyaply

theboyaply 我拉取了最新的镜像重新跑了一下，好像没什么问题了

jinqilin721

fantastic主题修改版本已支持1.3.0版本，有需要的：https://github.com/jinqilin721/halo-theme-fantastic
效果：https://blog.xinac.cn/ （支持看板娘、页面线条、音乐等插件）

Alicyu

jinqilin721 感谢！

classfang

附件上传中文名图片报错，原来的所有中文附件也404了。怎么解决。

peng

[root@peng ~]# sudo service halo status
Redirecting to /bin/systemctl status halo.service
● halo.service
   Loaded: loaded (/etc/systemd/system/halo.service; enabled; vendor preset: disabled)
   Active: active (running) since Sat 2020-03-28 14:57:40 CST; 3s ago
  Process: 16052 ExecStop=/bin/kill -s QUIT $MAINPID (code=exited, status=1/FAILURE)
 Main PID: 16055 (java)
   CGroup: /system.slice/halo.service
           └─16055 /usr/bin/java -server -Xms256m -Xmx256m -jar /usr/local/src/halo/halo-latest.jar

Mar 28 14:57:41 peng java[16055]: / / / /___ _/ /___
Mar 28 14:57:41 peng java[16055]: / /_/ / __ `/ / __ \
Mar 28 14:57:41 peng java[16055]: / __  / /_/ / / /_/ /
Mar 28 14:57:41 peng java[16055]: /_/ /_/\__,_/_/\____/
Mar 28 14:57:41 peng java[16055]: 
Mar 28 14:57:41 peng java[16055]: Version: 1.3.0

Java新手，请问这样是正常启动了吗？浏览器访问不到，之前1.2没问题，换了1.3的jar包就访问不了了。

Ryan Wang 👍

peng 从你这个日志上看，并没有问题。

ming4J

如果方便的话可以列出1.3.0版本支持的主题列表我的Walker主题貌似没有对新版本做支持

Ryan Wang 👍

ming4J Walker？请加我 709831589

peng

Ryan Wang 👍
1.3启动时比1.2多了下面一行，括号里是红字
Process: 18723 ExecStop=/bin/kill -s QUIT $MAINPID (code=exited, status=1/FAILURE)
如果没问题就是正常启动了，但是浏览器怎么也访问不到，1.2时可以，那有可能是哪里的问题呢？找了好久也没弄好😅

Ryan Wang 👍

1.3.1 发布

此版本为修复版，主要为了防止 fastjson 依赖之前爆出的高危漏洞会带来影响，这个版本建议都升级（没有升级 1.3.0 的可以直接升级这个版本），避免 fastjson 所带来的问题。

Fixed

修复自定义页面设置中的地址预览出现 undefined 的问题。
升级 fastjson 版本为 1.2.67。

Ryan Wang 👍

peng 看日志，~/.halo/logs/spring.log