diff --git a/2022/08/18/hello-world/index.html b/2022/08/18/hello-world/index.html new file mode 100644 index 00000000..52a90454 --- /dev/null +++ b/2022/08/18/hello-world/index.html @@ -0,0 +1,755 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + hello world - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

hello world

+ + +
+ +

梦开始的地方

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + +
+ +
+ + + + + +
+
+
hello world
+
https://www.hancher.top/2022/08/18/hello-world/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年8月18日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ +
+ + +
+
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/08/19/java-java-utils-1-Objects/index.html b/2022/08/19/java-java-utils-1-Objects/index.html new file mode 100644 index 00000000..cda69758 --- /dev/null +++ b/2022/08/19/java-java-utils-1-Objects/index.html @@ -0,0 +1,822 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + java中常用的工具类(1) Objects - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

java中常用的工具类(1) Objects

+ + +
+ +

在java生态中有着众多的工具类，而有的工具类是我们常用而且如果用的好，会极大提高代码的优雅性与效率的，同时也能避免重复的造轮子。接下来我们一起了解一下这些工具类。

+

Objects

+

Objects是jdk官方自带的工具类，首先我们来看看Objects的官方简介：

+
+

This class consists of static utility methods for operating on objects. These utilities include null-safe or null-tolerant methods for computing the hash code of an object, returning a string for an object, and comparing two objects.Since: 1.7

+
+

这是一个私有的工具类，用来提供一些对Object的操作方法，包括null值的安全操作，一级hash值的计算等实用方法。jdk1.7 就提供了。

+

Objects的提供的静态方法如下：
Objects的工具方法

+

equals

+

用来比较两个对象的是否相等，null安全的，可以替换繁琐的判空校验。实现逻辑：

+
1
2
3
public static boolean equals(Object a, Object b) {
       return (a == b) || (a != null && a.equals(b));
}
+ +

deepEquals

+

数组的深度比较，同样null安全的。实现逻辑：

+
1
2
3
4
5
6
7
8
public static boolean deepEquals(Object a, Object b) {
        if (a == b)
            return true;
        else if (a == null || b == null)
            return false;
        else
            return Arrays.deepEquals0(a, b);
    }
+ +

hashCode

+

获取一个对象的hashCode，同样null安全的。实现逻辑：

+ 
1
2
3
public static int hashCode(Object o) {
        return o != null ? o.hashCode() : 0;
    }
+ +

​

+

hash

+

对一个数组求hash值，同样null安全的。实现逻辑：

+
1
2
3
public static int hash(Object... values) {
      return Arrays.hashCode(values);
  }
+ +

toString

+

调用对象o的toString方法，同样null安全的。不过这里要注意一下，如果是null的话，会返回null字符串。

+

相对应的，还有一个重载方法，toString(Object o, String nullDefault) 。 能够自定义null值的返回值，这个挺实用的。

+

实现逻辑：

+
1
2
3
4
5
6
7
8
9
10
11
12
  public static String toString(Object o) {
      return String.valueOf(o);
  }

# String.valueOf 实现
  public static String valueOf(Object obj) {
      return (obj == null) ? "null" : obj.toString();
  }

  public static String toString(Object o, String nullDefault) {
      return (o != null) ? o.toString() : nullDefault;
  }
+ +

compare

+

自定义实现大小比较逻辑，同样null安全的。实现逻辑：

+
1
2
3
public static <T> int compare(T a, T b, Comparator<? super T> c) {
        return (a == b) ? 0 :  c.compare(a, b);
    }
+ +

isNull

+

判断对象是null, 可以用来替换 obj==null 的写法，更优雅。 实现逻辑：

+ 
1
2
3
public static boolean isNull(Object obj) {
        return obj == null;
    }
+ +

​

+

nonNull

+

判断对象非null, 可以用来替换 obj!=null 的写法，更优雅。 实现逻辑：

+ 
1
2
3
public static boolean nonNull(Object obj) {
        return obj != null;
    }
+ +

​

+

requireNonNull

+

断言判断，要求一个对象是非空的。如果为空则抛出异常，有三个重载方法，可以自定义不同的异常message。

+

实现逻辑：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public static <T> T requireNonNull(T obj) {
       if (obj == null)
           throw new NullPointerException();
       return obj;
   }

   public static <T> T requireNonNull(T obj, String message) {
       if (obj == null)
           throw new NullPointerException(message);
       return obj;
   }

   public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier) {
       if (obj == null)
           throw new NullPointerException(messageSupplier.get());
       return obj;
   }
+ + + +

好了，jdk自动的Objects方法就介绍这些，有时间 我们再聊聊其他的常用工具类。

+ + +
+ +
+
+
+ +
+ + + + + + + + + + java + + + > + + 工具类 + + + + + + + + + + +
+ + +
+ + + #java + +
+ +
+ + + + + +
+
+
java中常用的工具类(1) Objects
+
https://www.hancher.top/2022/08/19/java-java-utils-1-Objects/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年8月19日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/08/20/java-java-utils-2-system/index.html b/2022/08/20/java-java-utils-2-system/index.html new file mode 100644 index 00000000..f65cd1fc --- /dev/null +++ b/2022/08/20/java-java-utils-2-system/index.html @@ -0,0 +1,852 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + java中常用的工具类(2) System - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

java中常用的工具类(2) System

+ + +
+ +

System工具类也是java中常用的一个工具类，并且从java 1.0 时代就存在了。它是不能被实例化的。我们这里介绍一下它的简单用法.

+

下面是官方介绍

+
+

The System class contains several useful class fields and methods. It cannot be instantiated.
Among the facilities provided by the System class are standard input, standard output, and error output streams; access to externally defined properties and environment variables; a means of loading files and libraries; and a utility method for quickly copying a portion of an array.

+
+

以下介绍System的常用方法

+

流相关

1
2
3
4
5
6
// 设置标准输入流
public static void setIn(InputStream in);
// 设置标准输出流
public static void setOut(PrintStream out);
// 设置标准错误输出流
public static void setErr(PrintStream err);
+

以上的流就会在System的标准流中使用

+
1
2
3
System.in.read();
System.out.println();
System.err.println();
+

获取一个基础虚拟机的流通道

+
1
2
3
4
5
6
// Returns the channel inherited from the entity that created this Java virtual machine.
// This method returns the channel obtained by invoking the inheritedChannel method of the system-wide default SelectorProvider object.
// In addition to the network-oriented channels described in inheritedChannel, this method may return other kinds of channels in the future.
public static Channel inheritedChannel() throws IOException

System.out.println(System.inheritedChannel());//null
+

安全相关

设置或获取 java虚拟机的安全管理器。这个我用的比较少，大家看注释吧。

+
1
2
3
4
5
6
7
8
9
// Sets the System security.
// If there is a security manager already installed, this method first calls the security manager's checkPermission method with a RuntimePermission("setSecurityManager") permission to ensure it's ok to replace the existing security manager. This may result in throwing a SecurityException.
public static void setSecurityManager(final SecurityManager s);

// if a security manager has already been established for the current application, then that security manager is returned; otherwise, null is returned.
public static SecurityManager getSecurityManager();

// 默认
System.out.println(System.getSecurityManager());// null
+ +

控制台

获取java的控制台对象，关于控制台命令交互可以通过这里获取

+
1
2
3
4
// Returns the unique Console object associated with the current Java virtual machine, if any.
// Returns: The system console, if any, otherwise null. 
// Since: 1.6
public static Console console()
+ +

时间相关

这应该是大家使用最频繁的几个接口。

+
    +
  • 毫秒
    • +
+
1
2
3
4
// 获取当前系统时间戳（公元1970.1.1 凌晨到现在的毫秒数），native虚拟机实现
// the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC.
public static native long currentTimeMillis();

+
    +
  • 纳秒精度数
    • +
+

获取当前系统的纳秒精度的数（基于当前虚拟机）。这个数是依据当前虚拟机的一个原点计算出来的一个高精度值，与具体的时间无关（比如毫秒方法获取的是1970到今天的时间戳，但纳秒的原点不是具体的某个时间点）
所以，这个方法的用处也就有了，就是基于同一个虚拟机的纳秒级精度的前后时间比较。
因为数据比较大，可以会有越界风险

+
1
2
3
// Returns the current value of the running Java Virtual Machine's high-resolution time source, in nanoseconds.
// This method can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time. The value returned represents nanoseconds since some fixed but arbitrary origin time (perhaps in the future, so values may be negative). The same origin is used by all invocations of this method in an instance of a Java virtual machine; other virtual machine instances are likely to use a different origin.
public static native long nanoTime();
+ +

数据拷贝

说实话，不太理解为什么这个方法会放在这里。可能在虚拟机底层里，数组copy是一个基础功能吧。
很常用。

+
1
2
// 将src数组srcPos位置开始的length元素复制到dest数组中，从dest数组中的destPos开始。
public static native void arraycopy(Object src,  int  srcPos,Object dest, int destPos, int length);
+ +

hash

返回对象的默认hashcode（即时被覆盖也不执行覆盖方法）
null 返回0

+
1
2
// Returns the same hash code for the given object as would be returned by the default method hashCode(), whether or not the given object's class overrides hashCode(). The hash code for the null reference is zero.
public static native int identityHashCode(Object x);
+ +

系统属性

    +
  • 系统属性列表
    • +
+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Key :  Description of Associated Value
// java.version :  Java Runtime Environment version
// java.vendor : Java Runtime Environment vendor
// java.vendor.url: Java vendor URL
// java.home:  Java installation directory
// java.vm.specification.version : Java Virtual Machine specification version
// java.vm.specification.vendor : Java Virtual Machine specification vendor
// java.vm.specification.name : Java Virtual Machine specification name
// java.vm.version : Java Virtual Machine implementation version
// java.vm.vendor : Java Virtual Machine implementation vendor
// java.vm.name : Java Virtual Machine implementation name
// java.specification.version : Java Runtime Environment specification version
// java.specification.vendor : Java Runtime Environment specification vendor
// java.specification.name : Java Runtime Environment specification name
// java.class.version : Java class format version number
// java.class.path : Java class path
// java.library.path : List of paths to search when loading libraries
// java.io.tmpdir : Default temp file path
// java.compiler : Name of JIT compiler to use
// java.ext.dirs : Path of extension directory or directories Deprecated. This property, and the mechanism which implements it, may be removed in a future release.
// os.name : Operating system name
// os.arch : Operating system architecture
// os.version : Operating system version
// file.separator : File separator ("/" on UNIX)
// path.separator : Path separator (":" on UNIX)
// line.separator : Line separator ("\n" on UNIX)
// user.name : User's account name
// user.home : User's home directory
// user.dir : User's current working directory
public static Properties getProperties()


+
    +
  • 设置/替换系统属性
    • +
+
1
2
3
// 设置系统属性：props 换替换原来的系统属性，而非新增
public static void setProperties(Properties props)

+ +
    +
  • 设置key属性
    • +
+
1
2
3
// 设置key的属性，并返回上一个value值
public static String setProperty(String key, String value)

+ +
    +
  • 删除key属性
    • +
+
1
2
3
// 删除key ，并返回上个value值
public static String clearProperty(String key)

+ +
    +
  • 查询key属性
    • +
+
1
2
3
4
5
//根据key 查属性值
public static String getProperty(String key)
// 根据key 查属性值，查不到返回默认值
public static String getProperty(String key, String def)

+ +
    +
  • 系统换行符
    • +
+

linux/unix : \n
windows: \r\n

+
1
2
// On UNIX systems, it returns "\n"; on Microsoft Windows systems it returns "\r\n".
public static String lineSeparator()
+ +
    +
  • 系统环境变量
    • +
+
1
2
3
4
5
6
// 全部环境变量 k：v
public static java.util.Map<String,String> getenv()

// 某个k的环境变量值
public static String getenv(String name)

+ +

系统相关

    +
  • 退出
    • +
+

以某个状态终止虚拟机：非0 code 表示非正常结束

+
1
2
3
4
5
6
// Terminates the currently running Java Virtual Machine. The argument serves as a status code; by convention, a nonzero status code indicates abnormal termination.
// This method calls the exit method in class Runtime. This method never returns normally.
public static void exit(int status) {
    Runtime.getRuntime().exit(status);
}

+ +
    +
  • 垃圾回收
    • +
+

执行垃圾回收

+
1
2
3
4
// Runs the garbage collector.
public static void gc() {
    Runtime.getRuntime().gc();
}
+ +
    +
  • 执行Finalization
    • +
+
1
2
3
public static void runFinalization() {
    Runtime.getRuntime().runFinalization();
}
+ + +
+ +
+
+
+ +
+ + + + + + + + + + java + + + > + + 工具类 + + + + + + + + + + +
+ + +
+ + + #java + +
+ +
+ + + + + +
+
+
java中常用的工具类(2) System
+
https://www.hancher.top/2022/08/20/java-java-utils-2-system/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年8月20日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/08/23/algorithm-skill/index.html b/2022/08/23/algorithm-skill/index.html new file mode 100644 index 00000000..76f665ca --- /dev/null +++ b/2022/08/23/algorithm-skill/index.html @@ -0,0 +1,774 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 算法套路 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

算法套路

+ + +
+ +

平时在刷算法题的时候经常会遇到一些套路, 也就是一些类似的小技巧. 这类技巧能够快速的帮我们解决某一类的算法问题. 这里就是整理一下自己遇到的,总结的算法技巧, 以及这些技巧可以应用与哪些场景.

+

1 滑动窗口(双指针)

个人理解,滑动窗口 的基础就是双指针. 即一个快指针代指窗口的头部, 一个慢指针代指窗口的尾部. 滑动窗口经过的地方就是我们要处理的数据.

+

滑动窗口示意图

+

如图所示,我们的滑动创建运动方向从左往右, 已经经过了区域1,正在经历区域2,3,4. 还没有经历区域5.

+

1.1 滑动窗口的特性

通过上面分析可知, 滑动窗口是一个窗口经过一段连续的区域,并实时计算统计经过区域内的一些值. 所以滑动窗口很适用的场景特点也就出来了:

+
    +
  1. 单维度数据,比如字符串, 比如一维数组.
    2. +
  2. 结果值有连续特性要求的. 因为滑动窗口必然是连续经过计算区域的.所遇到的值也必然是连续的.
    3. +
+

1.2 常见场景

    +
  1. 计算一个字符串内不含有重复字符的
    2. +
+

未完待续

+ +
+ +
+
+
+ +
+ + + + + + + + + + 算法 + + + + + + + + +
+ + +
+ + + #算法 + +
+ +
+ + + + + +
+
+
算法套路
+
https://www.hancher.top/2022/08/23/algorithm-skill/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年8月23日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/01/java-java-doc-skill/index.html b/2022/09/01/java-java-doc-skill/index.html new file mode 100644 index 00000000..bae5acaf --- /dev/null +++ b/2022/09/01/java-java-doc-skill/index.html @@ -0,0 +1,845 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如何写好java注释 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

如何写好java注释

+ + +
+ +

什么是java注释

要回答这个问题,先提出一个说法:我们写的代码是给人看的,不是给机器看的.
如果你不认可这个说法,下面关于代码注释的一些总结想必对你也没啥帮助.
如果你认可这个说法, 那么下面的文章希望会给你一些帮助.

+

回到本段的主题,什么是java注释呢?

+
    +

  1. 首先,注释是面向代码维护者的: 注释是对代码逻辑的一段说明, 方便后续的代码维护者能够快速的了解这段代码的含义,并依次为基础能够在现有代码的基础上做修改与维护.

    +
    2. +

  2. 其次,注释是面向系统使用者的: 要知道类似于java,或者spring这样偏向于底层,框架类的代码.全世界有数以万计的使用者的,这些人没精力也没有必要在调用api的时候去了解这段代码的底层实现逻辑,所以这段代码的api说明文档就显得很重要了.而代码上的注释就是相关api文档的主要来源.

    +
    3. +

  3. 通过javadoc命令,可以将注释抽离生成html文档,比如官方的java16API文档

    +
    4. +
+

如何写好java注释

想要写好代码的注释,我们要从注释的面向用户来考虑.不同的用户关注点还是有点差异的.

+

面向代码维护者

作为一名代码的维护者,当我们拿到一份没有任何注释的代码的时候,相信大家内心的感受是相同的.毕竟人类的悲欢并不相通, 除非看到没有注释的代码.

+

如果有了解设计模式的朋友,相信一定听说过一个设计原则:开闭原则, 对扩展开发,对修改关闭. 那么大家有没有想过为啥会有这个原则呢?

+

翻译一下: 修改现有的代码是有风险的,但是如果是扩展写新代码的话,作为开发者的你,是了解当前功能的前后背景的,而且你无论怎么写都不会对历史功能产生影响.所以对我们的代码设计能力提出来要求.

+

再翻译一下: 原来的代码既然跑的好好的,为啥要修改它呢, 改出问题来算谁的?

+

再翻译一下: 为啥我们不敢改以前的代码呢?谁知道当时为啥要写这段逻辑,谁知道这段逻辑有谁在用?改好了没有夸, 改崩了有锅背.

+

这就是我们维护老代码的困境!

+

作为一名程序员,我们要有一个概念,我们的代码是我们某个时刻的思维逻辑的固化.
如果是一个比较简单的逻辑,注释可以简单写写.
如果是一段比较复杂的逻辑,那么我们的注释要能够描述清楚我们当时的这段逻辑的背景(为什么要写这段逻辑), 意图(这段逻辑要实现什么效果), 用法(这段逻辑改如何使用,以及谁在用), 最好能有修改建议.

+

在业界开源的代码里有很多比较好的例子,来个spring的:

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/**
 * AOP Alliance MethodInterceptor for declarative transaction
 * management using the common Spring transaction infrastructure
 * ({@link org.springframework.transaction.PlatformTransactionManager}/
 * {@link org.springframework.transaction.ReactiveTransactionManager}).
 *
 * <p>Derives from the {@link TransactionAspectSupport} class which
 * contains the integration with Spring's underlying transaction API.
 * TransactionInterceptor simply calls the relevant superclass methods
 * such as {@link #invokeWithinTransaction} in the correct order.
 *
 * <p>TransactionInterceptors are thread-safe.
 *
 * @author Rod Johnson
 * @author Juergen Hoeller
 * @see TransactionProxyFactoryBean
 * @see org.springframework.aop.framework.ProxyFactoryBean
 * @see org.springframework.aop.framework.ProxyFactory
 */
+ +

面向api使用者

对于api的使用者,注释文档的要求相对简单些.

+

他们只关心这个方法的功能是什么, 以及入参有哪些,出参会有哪些, 会不会抛异常等, 会不会返回null等. 他们不关心这个方法的内部实现逻辑是啥, 比如一个排序方法, 使用者不关心这个方法内部使用冒泡排序,还是快排, 只要能完成诉求就行.

+

所以,面向api的使用者的注释,原则就是让他知道这个方法怎么使用就行了.

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/**
* Returns an Image object that can then be painted on the screen. 
* The url argument must specify an absolute <a href="#{@link}">{@link URL}</a>. The name
* argument is a specifier that is relative to the url argument. 
* <p>
* This method always returns immediately, whether or not the 
* image exists. When this applet attempts to draw the image on
* the screen, the data will be loaded. The graphics primitives 
* that draw the image will incrementally paint on the screen. 
*
* @param  url  an absolute URL giving the base location of the image
* @param  name the location of the image, relative to the url argument
* @return      the image at the specified URL
* @see         Image
*/
public Image getImage(URL url, String name) {
try {
return getImage(new URL(url, name));
} catch (MalformedURLException e) {
return null;
}
}
+ +

写好java注释常用的技巧

常用的注释tag

    +
  1. @param 方法参数
    2. +
  2. @return 方法返回值
    3. +
  3. @throws 方法抛出的异常, java1.2后添加
    4. +
  4. @exception 同@throws
    5. +
  5. @see 查看参考代码
    6. +
  6. @author 标识作者
    7. +
  7. @version 代码版本
    8. +
  8. @since 从某个版本开始引入
    9. +
  9. @serial( @serialField @serialData)
    10. +
  10. @deprecated 废弃某个版本的代码
    11. +
+

常用的内联tag

    +
  1. {@code} : 代码高亮,等同于 {@literal}
    2. +
+
1
<code>{@literal}</code>
+ +
    +
  1. {@docRoot} : 标记文档的根路径,用来实现相对路径
    2. +
+
1
2
3
/**
* See the <ahref="{@docRoot}/copyright.html">Copyright</a>.
*/
+
    +
  1. {@inheritDoc} : 继承某个文档,嵌套文档使用
    2. +
  2. {@link url} : 在注释文本区域内, 内联一个链接
    3. +
+
1
2
Use the {@link #getComponentAt(int, int) getComponentAt} method.

+
    +
  1. {@linkplain url label} 相对于{@link}, 支持自定义label文案来代指这段url
    2. +
+
1
2
3
4
Refer to {@linkplain add() the overridden method}.
会显示为
Refer to 'the overridden method'.

+
    +
  1. {@literal} 转义用, 方便显示一些特殊字符
    2. +
  2. {@value} 常量时, 会直接显示标注代码的值
    3. +
+

注释语句中的小技巧

@param @return @throws

一个正常方法必然会用到的注释tag,
@param 代表方法的入参,
@return 代表方法的返回值.
@throws 代表可能引发方法中断的异常. 等同与 @exception
这里需要特别说明一下, 有些人可能觉得只有那些受检异常(也就是必须在方法签名里声明的异常)才需要在注释里声明@throws. 其实不是的. 所有引发程序中断的异常, 包括运行时异常都可以在注释里说明, 也可以在方法签名里添加. 尤其是自定义的异常.
举个例子:

+
1
2
3
4
5
6
7
8
9
/**
 * Return the underlying ThreadPoolExecutor for native access.
 * @return the underlying ThreadPoolExecutor (never {@code null})
 * @throws IllegalStateException if the ThreadPoolTaskExecutor hasn't been initialized yet
 */
public ThreadPoolExecutor getThreadPoolExecutor() throws IllegalStateException {
	Assert.state(this.threadPoolExecutor != null, "ThreadPoolTaskExecutor not initialized");
	return this.threadPoolExecutor;
}
+

这里的IllegalStateException 是一个RuntimeException异常, 我们在方法里可能抛出这个异常, 最好是在方法签名里声明一下, 然后在代码注释里说明一下.

+

@see

当前代码可以参考的其他代码, 后面跟代码的全路径,可以是类,方法,属性等.具体参考如下:

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@see #field
@see #Constructor(Type, Type...)
@see #Constructor(Type id, Type id...)
@see #method(Type, Type,...)
@see #method(Type id, Type, id...)
@see Class
@see Class#field
@see Class#Constructor(Type, Type...)
@see Class#Constructor(Type id, Type id)
@see Class#method(Type, Type,...)
@see Class#method(Type id, Type id,...)
@see package.Class
@see package.Class#field
@see package.Class#Constructor(Type, Type...)
@see package.Class#Constructor(Type id, Type id)
@see package.Class#method(Type, Type,...)
@see package.Class#method(Type id, Type, id)
@see package
+ +

@author

标识当前代码的作者是谁, 可以一个,也可以有多个.

+

@version @since

都是版本相关的tag
@version 标识当前版本好, 编译的时候会用到. 符合SCCS规范.
@since 标识这段代码的引入版本

+

@serial @serialField @serialData

序列化相关的属性, 标识哪些字段可以序列化,哪些不行.

+

@deprecated

废弃某段代码,表示不再维护,并在一段时间后会被删除. 标记后, 相关的引用位置会被标记为删除线.
个人认为这个tag还是很有用的:

+
    +
  1. 创建代码容易删除难, 这个tag能够很好的帮忙我们去下线不再维护的代码,减轻维护压力.(愿世界上屎山越来越少)
    2. +
  2. 方便我们代码升级. 如果我们要升级一段代码,先将老代码废弃,然后通过@see,引导用户使用新的方法.
    3. +
+
1
2
3
4
5
6
/**
* @deprecated  As of JDK 1.1, replaced by 
*               
 setBounds
* @see #setBounds(int,int,int,int)
*/
+ + +

html标签来排版

1
2
<p> : 新起一段
<br> : 换行
+ + +

代码块样式

想在JAVA的注释中添加一段代码,并且可以优雅的编译出来还是挺麻烦的.下面提供一种方法

+
1
2
3
4
5
6
7
8
9
10
11
12
/**
  * 下面的代码注释可以按代码格式编译
  * <pre class=code>
  *     citys : [
  *         beijing,
  *         shanghai
  *      ]
  * </pre>
  *
  */
 private List<String>> citys;

+ +

参考

官方文档
javadoc - The Java API Documentation Generator +
How and When To Deprecate APIs

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + + + + + + +
+ + +
+ + + #java + +
+ +
+ + + + + +
+
+
如何写好java注释
+
https://www.hancher.top/2022/09/01/java-java-doc-skill/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月1日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/09/site-beaudar-error/index.html b/2022/09/09/site-beaudar-error/index.html new file mode 100644 index 00000000..70202dcf --- /dev/null +++ b/2022/09/09/site-beaudar-error/index.html @@ -0,0 +1,821 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + beaudar评论插件及常见问题解决 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

beaudar评论插件及常见问题解决

+ + +
+ +

什么是beaudar

+

Beaudar 名称源于粤语“表达”的发音，是 Utterances 的中文版本,是一款基于github issue 的一个评论插件

+
+
    +
  • 开源
    • +
  • 没有追踪，没有广告，永久免费
    • +
  • 不保留数据，所有数据保存在用户 GitHub issue 中
    • +
  • 有源于 GitHub primer 的多个主题
    • +
  • 轻量化，没有字体下载，没有 JS 框架加载
    • +
+

本站的评论模块就是使用的 beaudar

+

使用

选择 Beaudar 将要连接的仓库, 也就是网站对应的github仓库。

+
    +
  1. 确保仓库是公开的，否则您的读者将无法查看 Issue(评论)。
    2. +
  2. 安装并确保 Beaudar app 已在仓库中安装，否则用户将无法发表评论。
    3. +
+

点击这里安装beaudar

+

安装beaudar
3. 将网站对应的分支配置到配置中，并确保 Issues 功能已打开。
4. 将以下脚本标记添加到博客的模板中。 将其放置在要显示注释的位置。 使用 .beaudar 和 .beaudar-frame 选择器自定义布局。

+
1
2
3
4
5
6
7
8
9
10
11
12
13
<script src="https://beaudar.lipk.org/client.js"
        repo="在此处输入仓库"
        branch="main"
        issue-term="pathname"
        label="tag"
        theme="github-light"
        keep-theme="false"
        loading="false"
        comment-order="desc"
        input-position="top"
        crossorigin="anonymous"
        async>
</script>
+

配置解读

+
    +
  • src : 评论插件客户端地址,不能动
    • +
  • repo : 网站仓库
    • +
  • branch : 网站部署分支
    • +
  • issue-term : 博客文章 与 Issue 的映射
      +
    • pathname : Beaudar 将搜索标题包含博客文章 URL 路径的 Issue。如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue。
      • +
    • url : Beaudar 将搜索标题包含博客文章 URL 的 Issue。 如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue
      • +
    • title: Beaudar 将搜索标题包含博客文章标题的 Issue。 如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue
      • +
    • og:title : Beaudar 将搜索标题包含博客文章页面 meta 元素 og:title 的 Issue。 如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue
      • +
    • preferred-color-scheme:您可以配置 Beaudar 以按编号加载特定的 Issue。 问题不会自动创建
      • +
    • 可以指定自己的名称: 将 Beaudar 配置为搜索标题包含您选择的特定名称的问题。如果未找到匹配问题，Beaudar 将自动创建第一次有人评论您的帖子时。Issue 的标题将是您选择的名称
      • +
    +
    • +
  • theme: 主题
    • +
  • keep-theme: 将主题设置保存到页面的 sessionStorage，修改主题后刷新，主题设置不会丢失
    • +
  • label: 将分配给 Beaudar 创建的问题的标签,标签名称区分大小写。该标签必须存在于您的仓库中，无法附加不存在的标签。标签名称支持添加表情符号
    • +
  • loading: 点击加载图标可跳转至官方页面。
    • +
  • comment-order: 评论的发表时间排序
    • +
  • input-position: 评论框位置,当选择将评论顺序设置为“降序”时，建议将评论框放置在“顶部”。因为当评论数量很多时候，发表评论后可以第一时间看到评论发表成功
    • +
  • crossorigin: 跨域
    • +
+

常见问题

缺少 “beaudar.json” 配置

缺少 "beaudar.json" 配置
原因: 现在github的默认主分支是main, 不在是master. 所以分支找不到.
配置的时候指定分支为main就可以了.

+

hexo-fluid主题下的使用

将上述的 script脚本 在_config.yml中按如下方式添加即可

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 自定义底部 HTML 内容（位于 footer 上方），也可用于外部引入 js css 这些操作，注意不要和 post.custom 配置冲突
custom_html: '
<script src="https://beaudar.lipk.org/client.js"
        repo="Hanchers/hanchers.github.io"
        branch="main"
        issue-term="pathname"
        label="tag"
        theme="github-light"
        keep-theme="false"
        loading="false"
        comment-order="desc"
        input-position="top"
        crossorigin="anonymous"
        async>
</script>
'
+

但是效果比较丑，需要自己去调整一下css才与整个主题适配, 建议使用fluid主题已经集成好的组件。
fluid主题下的beaudar 评论插件效果

+

参考

beaudar Q&A

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + + #beaudar + + #评论插件 + +
+ +
+ + + + + +
+
+
beaudar评论插件及常见问题解决
+
https://www.hancher.top/2022/09/09/site-beaudar-error/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月9日
+
+ + +
+
更新于
+
2025年1月9日
+
+ + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/12/es-reindex/index.html b/2022/09/12/es-reindex/index.html new file mode 100644 index 00000000..78ba454d --- /dev/null +++ b/2022/09/12/es-reindex/index.html @@ -0,0 +1,801 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Elasticsearch重建索引 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

Elasticsearch重建索引

+ + +
+ +

为什么要重建索引

众所周知, es是一种高效的数据查询,检索引擎。 可以对海量的数据进行快速的查询。但是在使用es的时候，经常会遇到一个比较尴尬的问题，那就是es索引里的字段类型是固定的，不可修改的。而es的索引又是可以自动扩展字段的。 这个时候自动扩展出来的字段就是使用了默认的字段类型(通常是text类型)。

+

惊不惊喜！

+

查看索引字段的方法:

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
GET /my_index

{
    "my_index":{
        "mappings":{
            "_doc":{
                "dynamic_templates":[
                    {
                        "string_fields":{
                            "match_mapping_type":"string",
                            "mapping":{
                                "type":"keyword"
                            }
                        }
                    }
                ],
                "properties":{
                    "field_a":{
                        "type":"keyword"
                    },
                    "field_b":{
                        "type":"date",
                        "format":"yyyy-MM-dd HH:mm:ss"
                    },
                    "field_c":{
                        "type":"text",
                        "norms":false,
                        "fields":{
                            "keyword":{
                                "type":"keyword",
                                "ignore_above":256
                            }
                        }
                    }
                }
            }
        }
    }
}

+ +

聪明的你肯定想到了, 如果我们忘记加字段了, 或者字段加错了要修改字段类型咋办? 这个时候场景的办法就只有一个了:

+

重建索引!

+

从数据库角度来看,也就是新增新表, 迁移数据, 删除老表.

+

背景 与 目标

Elasticsearch 版本 : v 6.6
目标: 在my_index 索引上新增一个integer字段. 且中间不间断服务.

+

S1: 使用别名代替实体索引

使用aliases api
创建一个别名my_index 指向实际的索引my_idex.
这样,我们通过my_index访问数据时, 就不会直接访问my_index索引了, 而是通过别名指向对应的索引.

+
1
2
3
4
5
6
POST /_aliases
{
    "actions" : [
        { "add" : { "index" : "my_index", "alias" : "my_index" } }
    ]
}
+ +

S2: 创建新的索引

使用 put mapping api
打算新增一个字段 fiedl_d, 数据类型.

+

因为默认的string类型是keyword (假设, 意会即可), 所以如果想要新增一个整型类型, 就不能通过自动的扩展字段使用默认类型的方式. 所以必须显式的指定字段类型.

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
put my_index2

{
    "_doc":{
        "dynamic_templates":[
            {
                "string_fields":{
                    "match_mapping_type":"string",
                    "mapping":{
                        "type":"keyword"
                    }
                }
            }
        ],
        "properties":{
            "field_a":{
                "type":"keyword"
            },
            "field_b":{
                "type":"date",
                "format":"yyyy-MM-dd HH:mm:ss"
            },
            "field_c":{
                "type":"text",
                "norms":false,
                "fields":{
                    "keyword":{
                        "type":"keyword",
                        "ignore_above":256
                    }
                }
            },
            "field_d":{
                "type":"integer"
            }
        }
    }
}
+ +

S3: 迁移数据

使用 Reindex api
将老的my_index 数据迁移到新的my_index2上.
这一步比较耗时, 做好心理准备.

+
1
2
3
4
5
6
7
8
9
POST _reindex
{
  "source": {
    "index": "my_index"
  },
  "dest": {
    "index": "my_index2"
  }
}
+ +

S4: 变更别名

使用aliases api
将别名从老的index, 指向新的index

+
1
2
3
4
5
6
7
POST /_aliases
{
    "actions" : [
        { "remove" : { "index" : "my_index", "alias" : "my_index" } },
        { "add" : { "index" : "my_index2", "alias" : "my_index" } }
    ]
}
+

S5: 将老索引的增量数据迁移到新索引上

处理迁移期间my_index 发生的增量数据

+
1
2
3
4
5
6
7
8
9
10
11
POST _reindex
{
  "size": 10000,
  "source": {
    "index": "my_index",
    "sort": { "date": "desc" }
  },
  "dest": {
    "index": "my_index2"
  }
}
+ +

S6: 删除老索引

使用 delete api

+
1
delete my_index
+ +

总结

至此, 整个重建索引过程完毕.
很麻烦吧.
为了不这么麻烦, 以后要给es 增加新字段时, 一定要先通过maping的方式先新增字段. 然后再在代码里处理相对应的逻辑.

+

over!

+

补充说明

可以通过put mapping的方式, 增量补充索引的字段

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
PUT my_index
{
  "mappings": {
    "_doc": {
      "properties": {
        "manager": {
          "properties": {
            "age":  { "type": "integer" },
            "name": { "type": "text"  }
          }
        },
        "employees": {
          "type": "nested",
          "properties": {
            "age":  { "type": "integer" },
            "name": { "type": "text"  }
          }
        }
      }
    }
  }
}
+ + +

参考

官方文档-api
官方文档-api2

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + > + + Elasticsearch + + + + + + + + + + +
+ + +
+ + + #elasticsearch + +
+ +
+ + + + + +
+
+
Elasticsearch重建索引
+
https://www.hancher.top/2022/09/12/es-reindex/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月12日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/13/site-github-repo-private/index.html b/2022/09/13/site-github-repo-private/index.html new file mode 100644 index 00000000..4dc3ba84 --- /dev/null +++ b/2022/09/13/site-github-repo-private/index.html @@ -0,0 +1,818 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使用私有仓库发布 GitHub Pages - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

使用私有仓库发布 GitHub Pages

+ + +
+ +

验证私有库发布文章

相信已经成功使用github建站的朋友们肯定会有一个想法, 就是可不可以将文章仓库私有也能实现建站的功能呢?

+

答案是可以的, 本文就是一个将一个公共仓库站点私有化后的例子. 并将过程总结一下, 方便大家参考使用.

+

站点私有化过程的的变与不变

首先,使用github pages建站, 项目名就固定死了,必然是<用户名>.github.io
其次,如果有域名的话,像域名配置等一些配置也是需要放到 外露站点下的.

+

除此之外, 其他的内容就就是可以变的了.因为github.io站点最终暴露的就是一个编译好的web静态网站.
至于源码是不是在这里,无所谓的.之所以源码与静态站点放到一起,核心还是方便github的 action自动编译.

+

好了, 了解了这些核心要素, 我们可以操作的部分也就有了.
就像我们正常的开发流程一样,我们可以把整个网站的发布流程拆分为两部分: 打包 与 发布.

+

其中打包可以在我们的私有仓库中进行, 然后将打包后的静态网站 发布到github.io公仓中.
这里就用到了github的 action 自动编译功能. 其会在我们提交代码的时候触发一个操作,
调用一段脚本命令执行.

+

而这段脚本的核心就是通过git 将编译后的静态站点push 到github.io公仓中.

+

流程如下:
发布流程图

+

操作步骤

    +
  1. 先在github上创建一个私有仓库: private_repo.
    2. +
  2. 将github.io的源码迁移到新的仓库中.
    3. +
  3. 准备github跨仓库git 提交代码权限, 参考下一节github申请person token
    4. +
  4. 在private_repo 的action 中创建打包脚本, 脚本内容参考附录1
    创建新action
    5. +
+

github申请person token

第一步, 获取token

    +
  1. 个人设置里找到入口
    person token 1
    2. +
  2. 找到开发者设置
    person token 2
    3. +
  3. 创建token
    person token 3
    4. +
+

这一步一定要记住创建好的token, 因为后面要用,而且这个页面刷新后就没了.

+

其实有过使用ssh经验的朋友们应该已经意识到了, 这一步其实就是一个创建ssh公钥的过程. 只不过这个公钥是放到github服务器上了.

+

第二步, 私有库配置

有了token, 正常来说就能提交代码了. 但是要知道这个东西是放到脚本里的, 明文暴露还是不太安全.
所以我们要在私有库里将这个token配置成一个环境变量,通过环境变量引用的方式使用,这样就安全多了.

+
    +
  1. 找到private_repo, 配置token环境变量
    person token 4
    person token 5
    2. +
  2. 配置完后, 我们就可以在脚本里通过环境变量来使用token了.
    3. +
+
1
${ { secrets.YOUR_REPO_SECRET_NAME } }
+ +

最后

可以尝试在私有库private_repo里提交文章了.

+

同时你会发现, github.io公仓里的内部全部被静态网站内容覆盖了. 不用担心,这是正常的.

+

附录1 : 完整脚本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# ci name
# ci 脚本名称
name: Deploy Jekyll site to public github repos

on:
  # Runs on pushes targeting the default branch
  # 当代码 push 到 main 分支时, 执行该脚本
  push:
    branches: ["main"]

  # Allows you to run this workflow manually from the Actions tab
  # 允许你 手动执行 这个脚本
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
# GITHUB_TOKEN 的操作权限
permissions:
  contents: read
  pages: write
  id-token: write

# Allow one concurrent deployment
concurrency:
  group: "pages"
  cancel-in-progress: true

# job 执行任务, 可以有多个, 默认并行运行, 可以通过 needs 关键字来设置依赖的其他 jobs
# step : 任务下的执行步骤, 一个job 会有多个步骤
# 操作:  一个step 下可以执行多个操作, 通常一行脚本为一个操作
jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      # 准备ruby 环境
      - name: Setup Ruby
        uses: ruby/setup-ruby@0a29871fe2b0200a17a4497bae54fe5df0d973aa # v1.115.3
        with:
          ruby-version: '3.0' # Not needed with a .ruby-version file
          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
          cache-version: 0 # Increment this number if you need to re-download cached gems
#      - name: Setup Pages
#        id: pages
#        uses: actions/configure-pages@v2
      # 打包 jekyll
      - name: Build with Jekyll
        # Outputs to the './_site' directory by default
#        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
        run: bundle exec jekyll build --verbose
        env:
          JEKYLL_ENV: production
       # 更新 打tar包
#      - name: Upload artifact
#        # Automatically uploads an artifact from the './_site' directory by default
#        uses: actions/upload-pages-artifact@v1

      - name: 增加外露github文件
        working-directory: ./_site  # jekyll 默认 build 到 _site 目录，因此设置命令执行的目录为 ./_site
        run: |  # run 后面加个 ‘|’ 然后换行可以同时执行多个命令，每行一个
          cp ../README.md .
 
      - name: 部署_site到博客网站仓库
        working-directory: ./_site
        run: |
          git init
          git checkout -b main
          git add -A
          git -c user.name='your_name' -c user.email='your_email' commit -m 'anything' 
          git push "https://${ { github.actor } }:${ { secrets.YOUR_REPO_SECRET_NAME } }@github.com/YOUR_GITHUB_IO_REPO" HEAD:main -f -q
+
    +
  • 将上面的your_name,your_email,anything 替换成自己的内容
    • +
  • YOUR_REPO_SECRET_NAME 替换成privat_repo的secret_token_name
    • +
  • YOUR_GITHUB_IO_REPO 替换成自己的github.io公仓
    • +
+

附录2 : github action 脚本简介

在github的action模块里创建了一个脚本后, 就会在项目的.github/workflows里创建一个对应的文件.

+

通过workflow 大致可以理解这个模块的功能, 就是一个工作流.
在一些操作执行(通常是提交代码)后, 触发一系列的后续自动化操作, 这些操作可以是并行的,也可以是串行的.

+

而这些后续操作是通过一些action脚本组织起来的. 整体上看,一个action由以下部分组成.

+
    +
  • jobs: 任务. 最大的逻辑单元. 可以有多个. jobs 默认是并行运行，可以通过 needs 关键字来设置依赖的其他 jobs。
    • +
  • steps: 步骤. job的执行步骤. 顺序执行. 可以job可以有多个步骤.
    • +
  • runs: 操作. 也可以理解为指令(bash命令等). 通常一行脚本就是一个操作. 并非所有步骤都会运行操作，但是操作都是在步骤中运行的
    • +
+

无论是job,还是step, 都可以理解一组指令集合. 他们都是可以配置id的. 可以通过id来互相依赖, 互相调用.

+

其他的可以参考里的官方文档.

+

参考

常见脚本

+

github action 官方文档

+

免费使用私有仓库发布 GitHub Pages

+

通过 GitHub Actions 实现私有仓库的免费 Github Pages 部署

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + +
+ +
+ + + + + +
+
+
使用私有仓库发布 GitHub Pages
+
https://www.hancher.top/2022/09/13/site-github-repo-private/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月13日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/22/exception-java-method-too-big/index.html b/2022/09/22/exception-java-method-too-big/index.html new file mode 100644 index 00000000..565f7249 --- /dev/null +++ b/2022/09/22/exception-java-method-too-big/index.html @@ -0,0 +1,783 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 有意思的小问题,java代码过长 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

有意思的小问题,java代码过长

+ + +
+ +

最近在练习编程的时候,发现一个问题. 就是在测试一个排序功能时, 如果写入大批量的参数, 会报 “java: 代码过长” 的问题.

+

编程这么多年了, 第一次遇到这种问题, 还挺神奇的. 记录和总结一下.

+

现象重现

1
2
3
4
5
6
7
8
public class Test {
    public static void main(String[] args) {
        a = "2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2";
        // 上面的a 多复制几遍

        System.out.println(a);
    }
}
+

很简单的代码, 没事走两步

+
1
java: 代码过长
+ +

问题分析

首先, 顾名思义, 很明细就是字符长度超过了java 一个类文件的最大长度限制导致的.

+

那么java类文件的长度是多少呢?
经过一番不是很辛苦的查询, 定位到了原因:

+
+

There is a 64K byte-code size limit on a method
java中一个方法的最大长度是64Kb

+
+

很明细, 我们的这个方法长度超了.

+

问题解决

原因找到了, 要解决也就很简单了. 只要做到规避方法的最大长度就行了.

+
    +
  • 方法1 : 将一个大方法拆成多个小方法, 将一个大类拆成多个小类. 说实话, 一个64kb的类确实有点大了.
    • +
  • 方法2 : 将测试数据不要放到java类里, 而是放到配置文件中, 使用的时候通过流加载到内存中. 文件的存储量是无限的
    • +
+

总结

其实只要符合正常的java编码规范, 我们基本上是遇不到上面的问题的.
只有在一些极限测试的时候, 我们通常会将测试内容放到代码里, 才可能碰到.

+

只能说: 没用的小知识又增多了🐶

+

参考

java code too large

+ + +
+ +
+
+
+ +
+ + + + + + + + + + java异常 + + + + + + + + +
+ + +
+ + + #java + + #异常 + +
+ +
+ + + + + +
+
+
有意思的小问题,java代码过长
+
https://www.hancher.top/2022/09/22/exception-java-method-too-big/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月22日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/29/db-redis-cmd-script/index.html b/2022/09/29/db-redis-cmd-script/index.html new file mode 100644 index 00000000..73a95323 --- /dev/null +++ b/2022/09/29/db-redis-cmd-script/index.html @@ -0,0 +1,785 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + redis脚本命令 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

redis脚本命令

+ + +
+ +

redis内置了Lua 5.1引擎. 可以很方便的执行lua脚本.
有了这个利器, 我们就可以在redis命令的基础上自己组合命令并原子性执行了.

+

eval命令执行lua脚本

如果要调用

+
1
2
EVAL script numkeys [key [key ...]] [arg [arg ...]]

+
    +
  • script lua脚本, 字符串
    • +
  • numkeys 后置keys的数量. 0表示没有参数
    • +
  • key 的参数. 可以在lua脚本里通过 “KEYS[index]”来指定key. 会在脚本执行前替换
    • +
  • arg 参数. 和keys类似. keys数量之后的参数都是args. 可以用ARGV[index]指定.
    • +
+

demo

+
1
2
3
4
5
6
7
# 执行一段lua脚本, 返回输入的各个参数. 前2个是key, 后面的都是args
redis> EVAL "return { KEYS[1], KEYS[2], ARGV[1], ARGV[2], ARGV[3] }" 2 key1 key2 arg1 arg2 arg3
1) "key1"
2) "key2"
3) "arg1"
4) "arg2"
5) "arg3"
+ +

lua脚本

lua脚本调redis指令

最常用的很是就是call方法了

+
1
2
redis.call(command [,arg...])

+
    +
  • command redis命令
    • +
  • args redis命令所需参数
    • +
+

demo

+
1
2
3
4
5
# 执行lua脚本, 设置key=a , v = 1
redis> eval "redis.call('set','a',1)" 0

# 验证
redis> get a  # 结果 1
+ + + +

不定期更新中…

+

参考

redis lua

+ + +
+ +
+
+
+ +
+ + + + + + + + + + redis + + + + + + + + +
+ + +
+ + + #redis + +
+ +
+ + + + + +
+
+
redis脚本命令
+
https://www.hancher.top/2022/09/29/db-redis-cmd-script/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月29日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/09/30/db-redis-common-cmd/index.html b/2022/09/30/db-redis-common-cmd/index.html new file mode 100644 index 00000000..bb6e7f23 --- /dev/null +++ b/2022/09/30/db-redis-common-cmd/index.html @@ -0,0 +1,769 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + redis常用命令总结 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

redis常用命令总结

+ + +
+ +

k-v操作

普通的k-v操作

+

批量操作

1.通过lua在redis客户端批量删除key

redis是不支持批量删除指令的, 因为redis是单线程的. 批量删除会占用redis的主线程.影响性能.

+

但是我认为现在redis既然已经支持异步线程操作一些后台数据了, 也就可以支持在不影响主线程性能的情况下实现 正则批量删除数据的命令了. 不知为何还是没有.

+

这里记录一下使用lua脚本, 在redis命令行里 通过正则批量删除缓存的功能. 核心是使用 keys命令. 这个会阻塞主线程, 如果量比较大, 慎用.

+
1
eval "local keys=redis.call('keys',KEYS[1]);local count=0;for i,v in ipairs(keys) do redis.call('del',v); count=i end; return count" 1 key正则表达式
+

将最后的’key正则表达式’换成自己想删除的keys的表达式即可.

+

关于量的问题, 我删除线上5w条缓存,秒删,无任何影响.各位同学自行参考量级.

+

不定期更新中…

+

参考

redis官网

+ + +
+ +
+
+
+ +
+ + + + + + + + + + redis + + + + + + + + +
+ + +
+ + + #redis + +
+ +
+ + + + + +
+
+
redis常用命令总结
+
https://www.hancher.top/2022/09/30/db-redis-common-cmd/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年9月30日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/10/05/exception-harmony-qa-http-request-err/index.html b/2022/10/05/exception-harmony-qa-http-request-err/index.html new file mode 100644 index 00000000..0cd105f3 --- /dev/null +++ b/2022/10/05/exception-harmony-qa-http-request-err/index.html @@ -0,0 +1,804 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鸿蒙应用开发:"request data error"问题解决 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

鸿蒙应用开发:"request data error"问题解决

+ + +
+ +

背景介绍

本人初次接触鸿蒙系统, 想着自己在手机上开发个app玩玩, 结果第一步就遇到坑了~~

+

开发环境

    +
  • ide: DevEco Studio 3.0 Release
    • +
  • harmony SDK: 8
    • +
  • 语言: ets/ts
    • +
  • 调试: 本地真机调试
    • +
+

请求源码

因为是个demo, 其实就是从官方demo中copy过来的, 然后换成自己的域名地址

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
import http from '@ohos.net.http';

// 每一个httpRequest对应一个http请求任务，不可复用
let httpRequest = http.createHttp();
// 用于订阅http响应头，此接口会比request请求先返回。可以根据业务需要订阅此消息
// 从API 8开始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。 8+
httpRequest.on('headersReceive', (header) => {
    console.info('header: ' + JSON.stringify(header));
});
httpRequest.request(
    // 填写http请求的url地址，可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
    "http://hancher.top/xxx/xxx",
    {
        method: http.RequestMethod.POST, // 可选，默认为http.RequestMethod.GET
        // 开发者根据自身业务需要添加header字段
        header: {
            'Content-Type': 'application/json'
        },
        // 当使用POST请求时此字段用于传递内容
        extraData: {
            "data": "data to send",
        },
        connectTimeout: 60000, // 可选，默认为60s
        readTimeout: 60000, // 可选，默认为60s
    }, (err, data) => {
        if (!err) {
            // data.result为http响应内容，可根据业务需要进行解析
            console.info('http请求结果:' + data.result);
            console.info('code:' + data.responseCode);
            // data.header为http响应头，可根据业务需要进行解析
            console.info('header:' + JSON.stringify(data.header));
            console.info('cookies:' + data.cookies); // 8+
        } else {
            console.info('http请求异常:' + JSON.stringify(err));
            // 当该请求使用完毕时，调用destroy方法主动销毁。
            httpRequest.destroy();
        }
    }
);
+

大家可以从参考里的官方demo里比对一下, 啥都没变, 然后本地调试, 报

+
1
03B00/JSApp:  app Log: http请求异常:{"code":200,"data":"request data error"}
+ +

多说一句, 因为是初次使用这个ide, 日志的打印入口都找了半天. 下面是日志的路径

+
+

底部导航log-> HiLog -> 选中自己的设备 -> 选择日志级别
HiLog 入口

+
+

问题定位

    +
  1. 首先, 请求肯定没有发出去. 因为我没有在我的后台里发现对应的请求
    2. +
  2. 有没有可能是请求参数体的问题呢?
    这个我查了半天官方文档, 以及自己试了字符串, 对应, 数组等各种方式, 都不行. 感觉应该不是这个问题.
    3. +
  3. 是不是权限的问题呢?
    之所以会怀疑到权限的问题上, 因为在查看接口文档的时候发现了这么一句话
    +

    需要权限：ohos.permission.INTERNET

    +
    +
    4. +
+

然后就去查权限相关的文档, 在模块的config.json下面把权限加上, 还是不行. 配置如下:

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.GET_NETWORK_INFO",
        "reason": "流量网络请求"
      },
      {
        "name": "ohos.permission.INTERNET",
        "reason": "流量网络请求"
      },
      {
        "name": "ohos.permission.SET_NETWORK_INFO",
        "reason": "流量网络请求"
      },
      {
        "name": "ohos.permission.MANAGE_WIFI_CONNECTION",
        "reason": "WLAN网络请求"
      },
      {
        "name": "ohos.permission.SET_WIFI_INFO",
        "reason": "WLAN网络请求"
      },
      {
        "name": "ohos.permission.GET_WIFI_INFO",
        "reason": "WLAN网络请求"
      }
    ]
  }
}

+

请求结果还是老样子.
4. 最终定位: http明文请求被限制了
这是我在一位老哥的帖子里发现的一个关键节点.
原来正常的http请求会被系统默认禁掉, 而且官方还不给个提示, 太坑了. 官方更推荐使用https的请求方式.
http被禁用
知道了问题所在, 解决问题就好了.config.json添加如下配置即可

+
1
2
3
4
5
6
7
"deviceConfig": {
  "default": {
    "network": {
      "cleartextTraffic": true
    }
  }
}
+ +

注意, 3里的网络权限也要配置哈, 不然会报没有权限的错误. 不过这个还好, 官方有异常提示了, 就很好定位了.

+

参考

http请求官方文档
应用配置官方文档
感谢老哥

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 鸿蒙 + + + > + + app + + + + + + + + + + +
+ + +
+ + + #鸿蒙 + + #异常 + +
+ +
+ + + + + +
+
+
鸿蒙应用开发:"request data error"问题解决
+
https://www.hancher.top/2022/10/05/exception-harmony-qa-http-request-err/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年10月5日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/10/06/dubbo-zk-change/index.html b/2022/10/06/dubbo-zk-change/index.html new file mode 100644 index 00000000..07d5180f --- /dev/null +++ b/2022/10/06/dubbo-zk-change/index.html @@ -0,0 +1,794 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + dubbo 在线平滑变更zookeeper - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

dubbo 在线平滑变更zookeeper

+ + +
+ +

记一次dubbo zk集群平滑迁移的操作方案，也可以用户dubbo双注册中心的实现方案。

+

准备

    +
  1. zk 服务器版本：3.4.6
    2. +
  2. dubbo 版本：2.7.3
    3. +
  3. dubbo-spring-boot-starter 版本：2.7.3
    4. +
+

技术方案

    +
  1. 运维同学搭建好新的zk集群，保证高可用
    2. +
  2. dubbo 服务提供者通过双注册中心的方式，将服务注册到new，old 两套集群上
    3. +
  3. dubbo 消费者 通过配置双注册中心的方式，同时消费两个注册中心的服务
    4. +
  4. 步骤2，步骤3可以同时进行，直到全部服务平滑注册到双注册中心
    5. +
  5. 等全部到双中心后（需要运维同学确认），再次更改消费者配置，改为new 注册中心
    6. +
  6. 关于即是生产者，又是消费者的项目，有两种方案：
      +
    • 等依赖上游切换后再切换，或者最后切换
      • +
    • 差异化配置，消费者单注册中心，生产者双注册中心
      • +
    +
    7. +
  7. 消费者全部切换到新的zk 集群后，生产者逐步全部改为新的zk集群
    8. +
  8. 关闭下线old zk 集群
    9. +
+

关键配置

pom 依赖

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>2.7.3</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-framework</artifactId>
    <version>4.2.0</version>
    <exclusions>
        <exclusion>
            <artifactId>zookeeper</artifactId>
            <groupId>org.apache.zookeeper</groupId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>4.2.0</version>
</dependency>
<dependency>
    <groupId>org.apache.zookeeper</groupId>
    <artifactId>zookeeper</artifactId>
    <version>3.4.13</version>
    <exclusions>
        <exclusion>
            <artifactId>slf4j-log4j12</artifactId>
            <groupId>org.slf4j</groupId>
        </exclusion>
    </exclusions>
</dependency>
+

dubbo配置：

+
1
2
3
4
5
6
7
8
9
10
11
12
dubbo:
  application:
    name: zk-move-test
  consumer:
    registries:
      - id: oldzk
        protocol: zookeeper
        address: 127.0.0.1:2181(此处随意配)
      - id: newzk
        protocol: zookeeper
        address: 127.1.1.1:2181,127.2.2.2:2181(此处随意配)

+

然后就能正常启动了，通过日志，会发现正常注册了两个zk中心，并且zk上也能发现注册的服务。

+

技术验证点

    +
  1. 某服务注册到old中心，new 中心没有，消费者双注册中心是否能发现？答：可以
    2. +
  2. 某服务注册到new 中心，old中心没有，消费者双注册中心是否能发现？答：可以
    3. +
  3. 某服务双注册中心，然后下线某注册中心，消费者双注册中心是否收影响，能否自动转移？
    答：经测试，new中心全部挂掉后，服务依旧会从old服务发现，功能不受影响。
    但是，dubbo客户端会一直尝试重新连接zk中心（可配置），直到new中心重启后，zk能够自动重连成功为止。所以，我们这个场景，需要生产、消费者全部迁移到new zk 上后才能下线old zk。
    4. +
+

参考文章

http://dubbo.apache.org/zh-cn/docs/user/references/registry/zookeeper.html

+ + +
+ +
+
+
+ +
+ + + + + + + + + + dubbo + + + + + + + + +
+ + +
+ + + #java + + #dubbo + +
+ +
+ + + + + +
+
+
dubbo 在线平滑变更zookeeper
+
https://www.hancher.top/2022/10/06/dubbo-zk-change/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年10月6日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/10/20/java-jdk-v19/index.html b/2022/10/20/java-jdk-v19/index.html new file mode 100644 index 00000000..67793fa9 --- /dev/null +++ b/2022/10/20/java-jdk-v19/index.html @@ -0,0 +1,985 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + JDK 19新特性简介 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

JDK 19新特性简介

+ + +
+ +

JDK 19在2022年10月18日发布了, 本文就是简单介绍一下这次更新的新特性与改动.

+

一句话总结, 这仍然是jdk的一个短期支持版本, 而且官方承诺,这次升级将尽可能的保证版本的向下兼容.

+

新特性汇总

新特性

1 预览版

    +
  • JEP 425 Virtual Threads(虚拟线程) : 类似go的协程. 就是在线程上面在开辟出一个更细粒度独立运行的单元. 这个新单元就是虚拟线程, 这个线程官方叫carrier thead(承载线程?)
    • +
  • JEP 405 Record Patterns (记录模式) : Record Patterns 可对 record 的值进行解构，Record patterns 和 Type patterns 通过嵌套能够实现强大的、声明性的、可组合的数据导航和处理形式.
    • +
  • JEP 427 Pattern Matching for switch (switch模式匹配) : 第三次预览. 用 switch 表达式和语句的模式匹配，以及对模式语言的扩展来增强 Java 编程语言。将模式匹配扩展到 switch 中，允许针对一些模式测试表达式，这样就可以简明而安全地表达复杂的面向数据的查询。
    • +
  • JEP 424 Foreign Function & Memory API (外边函数&内存调用API): 提供了一套API 方便的调用 Java 运行时之外的代码或内存。通过高效地调用外部函数（即 JVM 之外的代码）和安全地访问外部内存（即不受 JVM 管理的内存），该 API 使 Java 程序能够调用本机库并处理本机数据，而不会像 JNI 那样危险和脆弱. (Java 在堆外内存使用的路上越走越远 🤪)
    • +
+

2 孵化器

    +
  • JEP 428 Structured Concurrency(结构化并发) : 用来简化并发的功能. 可以将底层多个线程视为一个工作单元, 从而实现像单线程那样的异常处理, 结果收集.
    • +
  • JEP 426 Vector API (向量API) : 第四孵化阶段. 向量计算由对向量的一系列操作组成。向量 API 用来表达向量计算，该计算可以在运行时可靠地编译为支持的 CPU 架构上的最佳向量指令，从而实现优于等效标量计算的性能。向量 API 的目标是为用户提供简洁易用且与平台无关的表达范围广泛的向量计算
    • +
+

3 主要特性

    +

  • Support Unicode 14.0 (JDK-8268081) : 支持Unicode14.0 .

    +
    • +

  • New system properties for System.out and System.err (JDK-8283620) : 新增了stdout.encoding和 stderr.encoding 两个属性来支持标准输出和错误输出的字符集编码. 可以有效解决标准输出的乱码问题.

    +
    • +

  • HTTPS Channel Binding Support for Java GSS/Kerberos (JDK-8279842) : 在https连接的时候, 支持绑定token来增强安全.

    +
    • +

  • Additional Date-Time Formats (JDK-8176706) : java.time.format.DateTimeFormatter 增加了一些新的默认格式

    +
    • +

  • New Methods to Create Preallocated HashMaps and HashSets (JDK-8186958) : HashMap, HashSet新增了一些静态创建方法. 比如

    +
    1
    2
    3
    4
    5
    HashMap.newHashMap
    LinkedHashMap.newLinkedHashMap
    WeakHashMap.newWeakHashMap
    HashSet.newHashSet
    LinkedHashSet.newLinkedHashSet
    + + +
    • +

  • upport for PAC-RET Protection on Linux/AArch64 (JDK-8277204) : 通过支持ARMv8.3 的PAC功能来防御RET的攻击

    +
    +

    When enabled, OpenJDK will use hardware features from the ARMv8.3 Pointer Authentication Code (PAC) extension to protect against Return Orientated Programming (ROP) attacks. For more information on the PAC extension see “Providing protection for complex software” or the “Pointer authentication in AArch64 state” section in the Arm ARM.

    +
    +
    • +

  • Automatic Generation of the CDS Archive (JDK-8261455) : CDS的自动打包功能

    +
    • +

  • Windows KeyStore Updated to Include Access to the Local Machine Location (JDK-6782021) : Windows新增了一些密钥储库支持访问本地位置.

    +
    • +

  • Break Up SEQUENCE in X509Certificate and X509Certificate in otherName (JDK-8277976) : 如题, 这两个方法的增强.

    +
    +

    The JDK implementation of X509Certificate::getSubjectAlternativeNames and X509Certificate::getIssuerAlternativeNames has been enhanced to additionally return the type-id and value fields of an otherName. The value field is returned as a String if it is encoded as a character string or otherwise as a byte array, which is helpful as it avoids having to parse the ASN.1 DER encoded form of the name.

    +
    +
    • +

  • (D)TLS Signature Schemes (JDK-8280494): 增加了一套新的获取TLS签名的方法.

    +
    • +

  • Add a -providerPath Option to jarsigner (JDK-8281175) : jarsigner新增了一个选项, 用来指定备用密钥库路径

    +
    • +

  • New Options for ktab to Provide Non-default Salt (JDK-8279064) : ktab命令增加了一些选项来支持自定义’盐’值.

    +
    +

    ktab -a username password -s altsalt

    +
    +
    • +

  • New XML Processing Limits (JDK-8270504 (not public)) : xml库解析执行增加了3个限制

    +
    +

    jdk.xml.xpathExprOpLimit : XPath表达式中group数量的限制

    +

    jdk.xml.xpathExprOpLimit : XPath表达式中operator数量的限制

    +

    jdk.xml.xpathTotalOpLimit : XPath文件中operator总数量的限制

    +
    +
    • +
+

bug修复

    +
  • JDK-8289853 : HarfBuzz库升级 到 to 4.4.1, 支持最新的字体
    • +
  • JDK-8290334 : FreeType 升级到 2.12.1
    • +
  • JDK-8291897 : 解决TerminatingThreadLocal在virtual thread(虚拟线程)某些场景下无法注册的问题
    • +
  • JDK-8292240 : 虚拟线程的承载线程, 某些情况下阻塞时无法重置状态的问题
    • +
  • JDK-8287917 : macOS SDK 10.15 及更早版本下System.loadLibrary不生效的问题
    • +
  • JDK-8292654 : JDK-8286115问题修复导致的G1垃圾回收器 remembered set memory footprint问题
    • +
+

移出功能

    +
  • Diagnostic Flag GCParallelVerificationEnabled (JDK-8286304) : 这个开关被移出了. 因为自从创建以来一直都是默认开启, 且并发效率比关闭高很多.
    • +
  • Finalizer Implementation in SSLSocketImpl (JDK-8212136) : SSLSocket的finalizer被移除, 因为基础方法(native)已经实现相关功能.
    • +
  • Alternate ThreadLocal Implementation of the Subject::current and Subject::callAs APIs (JDK-8282676 (not public)) : 所述类里的相应方法的备用threadlocal实现被移除.
    • +
+

废弃功能

    +
  • java.lang.ThreadGroup (JDK-8284161) : 线程组被标记为废弃. 最大的原因是虚拟线程来了.
    • +
  • Locale Class Constructors (JDK-8282819) : Locale的构造器被 Locale.of() 方法替代
    • +
  • PSSParameterSpec(int) Constructor and DEFAULT Static Constant (JDK-8254935)
    • +
  • OAEPParameterSpec.DEFAULT Static Constant (JDK-8284553) : 因为密码学的进步, 这个Default常量已经落后了.
    • +
+

小优化

这里主要介绍一些小的优化, 太长可以不看.

+
    +

  1. JDK19中, 在macOS上将Metal作为图形渲染的默认配置.

    +
    2. +

  2. 像mac或linux系统中, user.home 存在就用系统提供的配置 , 如果不存在, 则使用$HOME的配置设置这个系统属性.

    +
    3. +

  3. 线程的ClassLoader 被处理为一个特殊的可继承的Thread-local

    +
    4. +

  4. java.lang.Thread 新增了一些方法, 如果现在代码继承了Thread, 可能会导致不兼容.

    +
    +

    Thread.Builder模式

    +

    Thread.isVirtual()

    +

    Thread.threadId()

    +

    Thread.join(Duration)

    +
    +
    5. +

  5. Double.toString(double) and Float.toString(float) 针对科学记数法的一些优化

    +
    6. +

  6. 注解的toString方法针对常量和枚举, 做了一些优化, 输出更友好.

    +
    7. +

  7. HTTP签名鉴权时, MD5和SHA-1 因为不太安全默认被禁用.

    +
    8. +

  8. Windows 上http多代理选择的优化

    +
    9. +

  9. java.net.InetAddress 针对一些有歧义的IPv4输入, 精细了异常提示.

    +
    10. +

  10. HttpURLConnection 的默认keep alive 可配置

    +
    11. +

  11. FileChannel.transferFrom 返回的bytes 可能会小于预订值, 这是允许的.

    +
    +

    FileChannel.transferFrom()的性能在Linux内核4.5及更高版本上得到了显著提高

    +
    +
    12. +

  12. InputStream and FilterInputStream 的mark和reset 移出了 synchronized 关键字

    +
    13. +

  13. Files.copy 方法支持将 POSIX属性跨文件系统复制, 前提是两个系统都支持 POSIX

    +
    14. +

  14. FileChannel.lock(long position, long size, boolean shared) 当size指定为0时, 表示锁定 整个文件, 无论这个文件流被扩展或继承

    +
    15. +

  15. java.time.chrono 新增了3个标准时间

    +
    16. +

  16. ForkJoinPool 和 ThreadPoolExecutor 线程池不再使用Thread.start来启动工作线程.

    +
    17. +

  17. 正则 \b 可以匹配ASCII 字符, 像 \w 一样.

    +
    18. +

  18. 支持 CLDR Version 41

    +
    19. +

  19. LDAP, DNS, 和 RMI 的URL解析更加严格

    +
    20. +
+
>    -Dcom.sun.jndi.ldapURLParsing="legacy" | "compat" | "strict"    (to control "ldap:" URLs)
+>
+>    -Dcom.sun.jndi.dnsURLParsing="legacy" | "compat" | "strict"     (to control "dns:" URLs)
+>    -Dcom.sun.jndi.rmiURLParsing="legacy" | "compat" | "strict"     (to control "rmi:" URLs)
+
+
    +

  1. VM Tool Interface (JVM TI) 支持虚拟线程

    +
    2. +

  2. cpu计算时不再考虑cpu.share , 因为会导致jvm对当前cpu使用情况的误算, 进而影响cpu使用率.

    +
    +

    之前的JDK版本对Linux cgroups参数“cpu.shares”使用了错误的解释。这可能会导致JVM使用的CPU少于可用，导致JVM在容器内使用时CPU资源利用率不足。

    +

    从此JDK版本开始，默认情况下，JVM在决定各种线程池使用的线程数量时不再考虑“cpu.shares”。-XX:+UseContainerCpuShares命令行选项可用于恢复到之前的行为。此选项已被弃用，可能会在未来的JDK版本中删除。

    +
    +
    3. +

  3. 此后, macOS中,相同大版本的jdk将默认安装到同一目录

    +
    +

    Oracle JDK安装目录从

    +

    /Library/Java/JavaVirtualMachines/jdk-${VERSION}.jdk 迁移到

    +

    /Library/Java/JavaVirtualMachines/jdk-${FEATURE}.jdk

    +

    比如: 19.0.1 and 19.0.2 版本都将安装到 /Library/Java/JavaVirtualMachines/jdk-19.jdk 中

    +
    +
    4. +

  4. 在macOS上，只有用户钥匙串中具有正确信任设置的证书才会在钥匙串类型的钥匙库中作为受信任证书条目公开

    +
    5. +

  5. RC2和ARCFOUR（RC4）算法已添加到java.security配置文件中的jdk.security.legacyAlgorithms安全属性中。当弱RC2或ARCFOUR算法用于与密钥存储中的秘密密钥条目关联的命令时，密钥工具会发出警告。

    +
    6. +

  6. 加密算法位数增强

    +
    7. +
+
+

RSA, RSASSA-PSS, DH: from 2048 to 3072

+

EC: from 256 to 384

+

AES: from 128 to 256 (if permitted by crypto policy), falls back to 128 otherwise.

+
+
    +
  1. ECDSA 算法的 Signature::getParameters 永远返回null . 参考 RFC 5758 Section 3.2
    2. +
  2. DES、DESede和MD5算法已添加到java.security配置文件中的jdk.security.legacyAlgorithms安全属性中。当弱DES或DESede算法用于与密钥库中的秘密密钥条目关联的命令时，keytool工具会发出警告。
    3. +
  3. 加密算法完成支持 RFC 6125
    4. +
  4. 移出了一些过时的3DES加密组件
    5. +
+
+

TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA

+

TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA

+

SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA

+

SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA

+

TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA

+

TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA

+

SSL_RSA_WITH_3DES_EDE_CBC_SHA

+
+

30 修复了一个StringBuilder bug. 例如, 下面代码输出”foofoobar” 而不是 “foobarfoobar”

+
1
2
StringBuilder builder = new StringBuilder("foo");
System.err.println("" + builder + builder.append("bar"));
+ +
    +

  1. JavaDoc生成的API文档现在提供了一个独立的搜索页面，搜索语法已得到增强，允许多个搜索词。

    +
    2. +

  2. JShell现在标记不建议使用的元素，并在控制台中突出显示变量和关键字。

    +
    3. +

  3. 实际的java线程堆栈大小可能与-Xss命令行选项指定的值不同；当操作系统要求时，它可以四舍五入到系统页面大小的倍数。

    +
    4. +
+

名词解析

    +

  • HarfBuzz: 一个开源的用于文字塑形的软件开发库，亦即用于转换Unicode文本到字形指标及方位的过程

    +
    • +

  • FreeType: 同HarfBuzz一样, 也是一个开源字体库. 它是一个用C语言实现的一个字体光栅化库。它可以用来将字符栅格化并映射成位图以及提供其他字体相关业务的支持

    +
    • +

  • Preview(预览): 功能已经基本完整, 可以试用了. 可以简单理解为beta公测版. 来源于 JEP12

    +
    +

    功能以预览版的形式发布，以收集有关它们的反馈而不承诺保持其向后兼容性——这意味着鼓励每个人尝试它们，但同时不鼓励在生产中使用它们。

    +

    预览功能不是开箱即用的，为了访问它们，需要使用*–enable-preview*编译器标志。

    +
    +
    • +

  • Incubator(孵化) : 实验性 API已经到了一定阶段, 已经计划开发出一整套完整的功能.以独立模块的形式发布. 来源于 JEP11

    +
    • +

  • Experimental(实验) : vm级的早期功能, 不稳定, 功能不完整. 实验性质.

    +
    +

    实验性功能代表（主要是）VM 级功能的早期版本，这些功能可能是有风险的、不完整的，甚至是不稳定的。在大多数情况下，需要使用专用标志启用它们

    +

    出于比较的目的，如果一个实验功能被认为是 25%“完成”，那么一个预览功能应该至少 95%“完成”。

    +

    预览,孵化,实验三者的关系大致: 实验 => 孵化 => 预览 => 合并jdk主体功能.

    +
    +
    • +

  • JEP : JDK Enhancement Proposal , jdk增强建议. 也就是我们常说的jdk新特性的来源. JEP大全

    +
    • +
+

参考文章

jdk19官方文档

+

jdk19 新特性文档

+

jdk19升级指南

+

jdk19的开发计划

+

openjdk bug反馈系统

+

openjdk官网

+

jdk中预览,实验,孵化的关系

+

FreeType开源中国

+

HarfBuzz开源中国

+ + +
+ +
+
+
+ +
+ + + + + + + + + + java + + + > + + java版本特性 + + + + + + + + + + +
+ + +
+ + + #java + +
+ +
+ + + + + +
+
+
JDK 19新特性简介
+
https://www.hancher.top/2022/10/20/java-jdk-v19/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年10月20日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/11/01/git-in-mac13-invalid/index.html b/2022/11/01/git-in-mac13-invalid/index.html new file mode 100644 index 00000000..2a933628 --- /dev/null +++ b/2022/11/01/git-in-mac13-invalid/index.html @@ -0,0 +1,778 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + macOS升级13 ventura后git无法使用的解决办法 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

macOS升级13 ventura后git无法使用的解决办法

+ + +
+ +

现象

最近, mac推送了新版本系统, macOS 13 ventura版本. 然后忍不住升级了. 升级过程不赘述, 等着就行了.

+

升级完成后, 打开idea, 发现git无法使用了, 提示如下:

+
1
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
+

不用说, 一定是升级导致的问题.

+

解决

经过一番排查, 发现是mac的开发工具Xcode需要升级到14才行. 可以使用如下命令解决, 实测有效

+
1
xcode-select --install
+

基本到这里, 问题就解决了.
如何还不行, 可以自行到官网下载软件安装即可.
xcode14图片

+

总结

没事别乱升级系统

+

参考

解决方案

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + > + + git + + + + + + + + + + +
+ + +
+ + + #git + +
+ +
+ + + + + +
+
+
macOS升级13 ventura后git无法使用的解决办法
+
https://www.hancher.top/2022/11/01/git-in-mac13-invalid/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年11月1日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2022/11/17/es-query-dsl-wrapper/index.html b/2022/11/17/es-query-dsl-wrapper/index.html new file mode 100644 index 00000000..c9c86c78 --- /dev/null +++ b/2022/11/17/es-query-dsl-wrapper/index.html @@ -0,0 +1,803 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + es在java工程中如何支持自定义的json格式的DSL - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

es在java工程中如何支持自定义的json格式的DSL

+ + +
+ +

背景

版本

    +
  • Elasticsearch : v 6.6
    • +
  • elasticsearch-rest-high-level-client.jar : v 6.6.2
    • +
+

目标

想提供一个web接口, 入参就是es的查询DSL json. 然后服务器用这个DSL透传转发到Elasticsearch服务期, 将数据返回给接口.
简单来说, 就是想在自己服务器上实现类似kibana上查询Elasticsearch数据的功能.

+

比如, 我们正常的查询DSL如下:

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
    "size":1,
    "query":{
        "bool":{
            "filter":[
                {
                    "terms":{
                        "userCode":[
                            "110111"
                        ]
                    }
                },
                {
                    "term":{
                        "address":{
                            "value":"beijing"
                        }
                    }
                }
            ]
        }
    }
}
+ +

实现

查询

如果是单纯的查询, 官方提供了一个透传查询DSL的实现类 QueryBuilders.wrapperQuery(), 可以通过这个QueryBuilders来实现我们自定义DSL的透传.
让我们先看看官方怎么说

+
+

A query that accepts any other query as base64 encoded string.
This query is more useful in the context of the Java high-level REST client or transport client to also accept queries as json formatted string. In these cases queries can be specified as a json or yaml formatted string or as a query builder (which is a available in the Java high-level REST client).

+
+

官方示例:

+
1
2
3
4
5
6
7
8
9
curl -X GET "localhost:9200/_search?pretty" -H 'Content-Type: application/json' -d'
{
    "query" : {
        "wrapper": {
            "query" : "eyJ0ZXJtIiA6IHsgInVzZXIiIDogIktpbWNoeSIgfX0=" 
        }
    }
}
'
+

由此可见, 官方是将wrapper当做一个关键字类型来处理的, 将我们的查询DSL转成base64,交给es服务器解析处理.
好,下面就是我们将上述DSL 通过QueryBuilders.wrapperQuery()处理后的sql.

+
1
2
3
4
5
{
  "wrapper" : {
    "query" : "eyJzaXplIjoxLCJxdWVyeSI6eyJib29sIjp7ImZpbHRlciI6W3sidGVybXMiOnsidXNlckNvZGUiOlsiMTEwMTExIl19fSx7InRlcm0iOnsiYWRkcmVzcyI6eyJ2YWx1ZSI6ImJlaWppbmcifX19XX19fQ=="
  }
}
+

大家可以找个base64解码网站处理一下, 发现和我们的DSL一样. 然后用官方的方式处理下

+
1
2
3
4
5
6
7
{
  "query" : {
    "wrapper": {
      "query" : "eyJzaXplIjoxLCJxdWVyeSI6eyJib29sIjp7ImZpbHRlciI6W3sidGVybXMiOnsidXNlckNvZGUiOlsiMTEwMTExIl19fSx7InRlcm0iOnsiYWRkcmVzcyI6eyJ2YWx1ZSI6ImJlaWppbmcifX19XX19fQ=="
    }
  }
}
+

唉, 发现查询报错了, 为什么呢?
size malformed

+

其实仔细分析一下,很容易发现问题. 我们将base64还原,看看最后的查询DSL的样子

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "query":{
    "wrapper":{
      "query":{
        "size":1,
        "query":{
          "bool":{
            "filter":[
              {
                "terms":{
                  "userCode":["110111"]
                }
              },
              {
                "term":{
                  "address":{"value":"beijing"}
                }
              }
            ]
          }
        }
      }
    }
  }
}
+

发现没, query里套query, 明显查询有问题. 其实这里es解析的时候, 发现wrapper关键字, 就会将下面的query查询替换原始query.

+

所以我们要将wrapper的不是原始完整的DSL,而是query下面的DSL. 我们将bool关键字的JSON重新单独拿出来处理下

+
1
2
3
4
5
6
7
{
  "query" : {
    "wrapper": {
      "query" : "eyJib29sIjp7ImZpbHRlciI6W3sidGVybXMiOnsidXNlckNvZGUiOlsiMTEwMTExIl19fSx7InRlcm0iOnsiYWRkcmVzcyI6eyJ2YWx1ZSI6ImJlaWppbmcifX19XX19"
    }
  }
}
+

搞定, 把上述DSL放到任何一个es的web客户端查询, 都有效.

+

聚合

关于聚合的功能, 官方没有提供现成的解析方法.
不过我觉得, 既然es的web端可以调用任意DSL, 通过java肯定能, 大不了就跳过RestHighLevelClient, 在RestLowLevelClient上想办法.

+

// todo 等我找到合适的办法再补充.

+

java源码

1
2
3
4
5
6
7
8
9
10
11
class A {
    public void search(String boolJson) throws IOException {

        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
        // query dsl 包装
        searchSourceBuilder.query(QueryBuilders.wrapperQuery(boolJson));
        searchSourceBuilder.size(1);
        
        Optional<SearchResponse> response = restHighLevelClient.search(searchSourceBuilder);
    }   
}
+ +

参考

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + > + + Elasticsearch + + + + + + + + + + +
+ + +
+ + + #elasticsearch + +
+ +
+ + + + + +
+
+
es在java工程中如何支持自定义的json格式的DSL
+
https://www.hancher.top/2022/11/17/es-query-dsl-wrapper/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2022年11月17日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/03/24/homebrew-install-nginx/index.html b/2023/03/24/homebrew-install-nginx/index.html new file mode 100644 index 00000000..148e4961 --- /dev/null +++ b/2023/03/24/homebrew-install-nginx/index.html @@ -0,0 +1,801 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + mac系统通过homebrew安装nginx - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

mac系统通过homebrew安装nginx

+ + +
+ +

准备

    +
  • mac系统
    • +
  • homebrew 环境已经配置好
    • +
+

操作步骤

    +
  1. 查看本地是否安装nginx
    2. +
+
1
brew search nginx
+

brew-search-nginx-not-find
nginx上面没有显示✓,表示nginx没有安装

+
    +
  1. 查看nginx信息
    2. +
+
1
brew info nginx
+

brew-info-nginx-not-find
如图所示,显示了nginx的版本. 也明确说明了系统没有安装nginx
3. 安装nginx

+
1
brew install nginx
+

brew-install-nginx-success
安装nginx成功.
nginx默认监听8080端口, 配置文件路径也给出来了 /opt/homebrew/etc/nginx/nginx.conf
同时也给了启动nginx的命令

+
1
brew services start nginx
+ +

4.验证安装成功
此时,nginx命令已经生效了.

+
1
nginx -v
+

nginx-version

+

当然, 也可以执行下面命令查看更详细的信息

+
1
nginx -V
+

至此,nginx已经安装成功了. 可以通过去配置文件修改相应配置, 启动nginx了

+

启动nginx

1
2
3
# 启动
nginx
brew services start nginx
+

启动成功了,此时可以通过 http://localhost:8080 验证一下
nginx-http

+

补充nginx的常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 查看版本
nginx -v
nginx -V

# 启动
nginx # 加载默认配置
nginx -c 配置文件路径 # 加载指定配置文件
brew services start nginx


# 停止
nginx -s stop # 快速停止
nginx -s quit # 安全停止

# 不重启加载配置
nginx -s reload 

# 验证配置
nginx -t

+

好的, 接下来尽情使用自己的nginx服务器吧!

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + > + + nginx + + + + + + + + + + +
+ + +
+ + + #nginx + +
+ +
+ + + + + +
+
+
mac系统通过homebrew安装nginx
+
https://www.hancher.top/2023/03/24/homebrew-install-nginx/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年3月24日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/03/26/net-intranet-frp/index.html b/2023/03/26/net-intranet-frp/index.html new file mode 100644 index 00000000..0b8cf63c --- /dev/null +++ b/2023/03/26/net-intranet-frp/index.html @@ -0,0 +1,810 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 通过frp实现内网穿透功能 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

通过frp实现内网穿透功能

+ + +
+ +

让我们从0开始搭建一个很酷的内网穿透功能.

+

作为一名程序员,谁不想拥有一个自己的云服务器呢. 但是当我们看了各大云服务器厂商的价格后, 不禁陷入了沉思:我好像对云服务器的诉求也没那么大!
等我们回家看到家里闲置的老旧电脑时,又会想,我为啥要用云服务器呢,家里的电脑改吧改吧, 不也就可以用了. 我们又不用做大流量的网站,
最多搞搞博客,跑跑爬虫啥的,只要能让我们可以随时在外面访问我家里的电脑,控制家里的电脑就行了.
好的,说干就干, 经过一番调研, 我们发现, 好像没自己想象的那么简单. 一个最直接的问题就是, 我们没有一个自己的ip,因为众所周知的ipv4资源耗尽的问题,
我们家里实际上网的ip其实不是固定的, 而是多家用户共享一个ip地址,也就是NAT(Network Address Translation)技术. 所以,从外网我们是无法直接访问家里的电脑的.
这个问题怎么解决呢? 就是我们今天要聊的话题, 内网穿透技术.

+

什么是内网穿透

内网穿透，也即NAT穿透，进行NAT穿透是为了使具有某一个特定源IP地址和源端口号的数据包不被NAT设备屏蔽而正确路由到内网主机.
大致流程如图:
内网穿透图

+

准备工作

    +
  1. 一台云服务器, 最便宜的即可,我们主要用其来注册内网服务器, 转发请求
    2. +
  2. frp工具
    3. +
  3. 家用电脑,台式,笔记本都行,操作系统任意.
    4. +
+

开始内网穿透

云服务器搭建frp服务

参考官方安装frp说明, 下载合适自己服务器的frp版本, 解压到自定义的frp服务目录.
因为是服务器部分, 我们直接启用frps 即可启动成功frp的服务部分.

+
1
2
# 启动frps, 并指定配置文件为frps.ini 
./frps -c ./frps.ini
+

配置部分参考官方配置样例. 我们demo样例只使用ssh基本服务, 就用了默认配置.

+
1
2
[common]
bind_port = 7000
+ +

配置frps为系统服务(选做)

为了方便, 我们一般会将frps配置成系统重启自动加载. 这样我们就不用担心服务器系统重启导致内网穿透服务掉线了.
方法如下:

+
    +
  1. 先确认系统支持systemd, 如果不支持请安装
    2. +
+
1
2
3
4
# yum
yum install systemd
# apt
apt install systemd
+
    +
  1. 配置frps.service服务
    2. +
+
1
vim /etc/systemd/system/frps.service
+

写入下面内容

+
1
2
3
4
5
6
7
8
9
10
11
12
13
[Unit]
# 服务名称，可自定义
Description = frp server
After = network.target syslog.target
Wants = network.target

[Service]
Type = simple
# 启动frps的命令，需修改为您的frps的安装路径
ExecStart = /path/to/frps -c /path/to/frps.ini

[Install]
WantedBy = multi-user.target
+
    +
  1. 开机自动启动
    2. +
+
1
systemctl enable frps
+ +

家用电脑安装frp客户端

我家里的电脑是windows10, 当然, Linux更好. 本次内网穿透的目的是可以通过远程ssh控制我的家用电脑.

+

win10的一些准备功能

windows系统作为家用本, 对网络权限限制的比较多, 需要我们额外做一些操作.
a. 安装windows的ssh服务端
win10默认是不支持ssh的服务端的, 需要我们安装相应的OpenSSH服务器.
操作步骤: 设置->应用-> 应用与功能 -> 可选功能 -> 添加OpenSSH服务器
openssh-s1
openssh-s2
openssh-s3
最后开启ssh服务,以管理员身份打开cmd终端,执行如下命令

+
1
net start sshd
+

b. 防火墙可能会将frpc识别为危险文件, 记得去防火墙那里将工具恢复.

+

配置frp客户端

从官网下载下frpc客户端后,且成功从防火墙那里逃生, 就可以继续后面的操作了
首先同样先修改配置文件

+
1
2
3
4
5
6
7
8
9
10
11
12
13
[common]
# 你的云服务器实际ip
server_addr = x.x.x.x 
# 云服务配置的端口
server_port = 7000

[ssh]
type = tcp
local_ip = 127.0.0.1
# 本地要暴露的端口, windows网络限制比较严格,记得去防火墙打开相应端口
local_port = 22
# 远程服务器监听的端口. 意思就是frps服务器监听6000的端口, 然后把请求转发的本地的22端口上.
remote_port = 6000
+

然后打开cmd终端使用命令行的方式启动frpc工具
最后就可以在外网使用ssh命令访问你的系统了

+
1
ssh -oPort=6000 你的系统用户名@x.x.x.x
+

frp 会将请求 x.x.x.x:6000 的流量转发到内网机器的 22 端口

+

修改window默认终端为powerShell(选做)

windows的默认终端为cmd, 很多命令不与linux兼容. 所以建议将windows的默认终端改为powerShell, 更方便.

+
1
New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" -PropertyType String -Force
+ +

参考

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + + + + + + +
+ + +
+ + + #内网穿透 + +
+ +
+ + + + + +
+
+
通过frp实现内网穿透功能
+
https://www.hancher.top/2023/03/26/net-intranet-frp/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年3月26日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/04/04/java-jdk-v20/index.html b/2023/04/04/java-jdk-v20/index.html new file mode 100644 index 00000000..f862f8d2 --- /dev/null +++ b/2023/04/04/java-jdk-v20/index.html @@ -0,0 +1,858 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + JDK 20新特性简介 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

JDK 20新特性简介

+ + +
+ +

jdk20
按照JDK每半年发布一次版本的节奏, JDK20在2023年3月发布了, 本文就是简单介绍一下这次更新的新特性与改动.

+

一句话总结, 这仍然是jdk的一个短期支持版本,此版本包括7个 JEP（jdk增强建议），以及数百个较小的功能增强和数千个错误修复.

+

新特性汇总

预览特性

语言特性:

    +
  • JEP 432 Record Patterns(记录模式) : 第2预览阶段. 记录模式是java语言的一个新语言特性.其目的是将我们从java复杂的类构造中解放出来,更关注于数据. 一般用于一组数据构成的一个整体,比如坐标point(x,y).
    • +
  • JEP 433 Pattern Matching for switch(switch记录模式):第4次预览, switch语法支持记录模式.
    • +
+

API库扩充:

    +
  • JEP 434 Foreign Function &Memory AP(访问jvm外部函数或内存的API) : 引入一个API，通过该API，Java程序可以在Java运行时之外与代码和数据进行互操作。通过有效地调用外部函数（即JVM外部的代码），并通过安全访问外部内存（即不由JVM管理的内存），API使Java程序能够调用本机库并处理本机数据，而没有JNI的脆性和危险性。
    • +
  • JEP 438 Vector API(向量API): 第5孵化阶段.向量计算由对向量的一系列操作组成。向量 API 用来表达向量计算，该计算可以在运行时可靠地编译为支持的 CPU 架构上的最佳向量指令，从而实现优于等效标量计算的性能。向量 API 的目标是为用户提供简洁易用且与平台无关的表达范围广泛的向量计算.
    • +
+

并发增强:

    +
  • JEP 429 Scoped Values(作用域值) : 孵化阶段.引入范围值，允许在线程内和线程之间共享不可变的数据。它们优于线程本地变量，特别是在使用大量虚拟线程时。因为变量是不可变的,也就避免了并发问题.
    • +
  • JEP 436 Virtual Threads(虚拟线程) : 第2预览阶段. 将虚拟线程引入Java平台。虚拟线程是轻量级线程，大大减少了编写、维护和观察高吞吐量并发应用程序的工作量. 本次主要是一些核心功能升级.
    • +
  • JEP 437 Structured Concurrency(结构化并发) : 第2孵化阶段. 通过引入结构化并发的API来简化多线程编程。结构化并发将在不同线程中运行的多个任务视为单个工作单元，从而简化错误处理和取消，提高可靠性并提高可观察性。
    • +
+

主要特性

核心库

    +
  • Support Unicode 15.0 (JDK-8284842) : 支持Unicode15.0 .
    • +
  • Print Warning to Standard Error If Bad java.io.tmpdir Setting Is Detected (JDK-8290313) : 新增一种警告输出场景
    • +
+

安全

    +
  • New JFR Event: jdk.InitialSecurityProperty (JDK-8292177) : 新增一个新的JFR(Java Flight Recorder)事件.
    • +
  • New JFR Event: jdk.SecurityProviderService (JDK-8254711) : 新增一个新的JFR(Java Flight Recorder)事件.
    • +
  • Provide Poly1305 Intrinsic on x86_64 platforms with AVX512 instructions (JDK-8288047) : 此功能在x86_64平台上使用AVX512指令为SunJCE提供商的Poly1305消息身份验证代码算法提供优化。
    • +
  • Provide ChaCha20 Intrinsics on x86_64 and aarch64 Platforms (JDK-8247645) : 此功能为SunJCE提供商提供的ChaCha20密码提供了优化的内在实现。这些优化的例程专为支持AVX、AVX2和/或AVX512指令集的x86_64芯片组以及支持高级SIMD指令集的aarch64芯片组而设计。
    • +
  • (D)TLS Key Exchange Named Groups (JDK-8281236) : 加密功能增强.
    • +
  • DTLS Resumption Uses HelloVerifyRequest Messages (JDK-8287411) : 加密功能增强.
    • +
+

工具

    +
  • Javac Warns about Type Casts in Compound Assignments with Possible Lossy Conversions(JDK-8244681) : javac命令增加了有损类型强转警告.
    • +
  • New ‘jmod –compress’ Command Line Option(JDK-8293499) : 在jmod工具中添加了一个新的–compress命令行选项，以便在创建JMOD存档时指定压缩级别。接受的值是zip-[0-9]，其中zip-0不提供压缩，zip-9提供最佳压缩。默认是zip-6。
    • +
+

jdk20 工具箱全集
java-bin

+

虚拟机

    +
  • add bean for Remark and Cleanup Pause Time in G1 (JDK-8297247) : G1垃圾回收在标记和清理阶段引入了一个新的回收bean : “G1 Concurrent GC”
    • +
+

移出功能

    +
  • Thread.suspend/resume Changed to Throw UnsupportedOperationException (JDK-8249627) : 在此版本中，使用Thread.suspend()和Thread.resume()方法暂停或恢复线程的能力已被删除。方法已更改为抛出UnsupportedOperationException。这些方法本质上容易陷入僵局，自JDK 1.2（1998年）以来已被弃用。ThreadGroup中的相应方法，即暂停或恢复一组线程，已更改为在Java 19中抛出UnsupportedOperationException。
    • +
  • Thread.Stop Changed to Throw UnsupportedOperationException (JDK-8289610) : 在此版本中，使用Thread.stop()方法“停止”线程的功能已被删除。该方法已更改为抛出UnsupportedOperationException。通过使其抛出java.lang.ThreadDeath来阻止线程本质上是不安全的。自JDK 1.2（1998）以来，停止方法已被弃用。ThreadGroup中的相应方法“停止”一组线程，已更改为在Java 19中抛出UnsupportedOperationException。同时, java.lang.ThreadDeath也被标记为废弃.
    • +
  • Remove Support for javac -source/-target/–release 7 (JDK-8173605) : javac移出了一些选项
    • +
  • Improved Control of G1 Concurrent Refinement Threads (JDK-8137022): G1并发细化线程的控制已被完全取代。新控制器通常分配更少的线程。它在细化线程活动中的峰值往往较少。它还倾向于延迟细化，当对相同或附近位置有多个写入时，允许通过写入屏障进行更多过滤，从而提高屏障的效率。
    • +
+

废弃功能

    +
  • java.net.URL Constructors Are Deprecated (JDK-8294241) : 废弃URL构造方法,推荐使用 java.net.URI 来构建URL.
    • +
  • Deprecate JMX Management Applets for Removal (DK-8297794) : 废弃JMX
    • +
+

小优化

这里主要介绍一些小的优化, 太长可以不看.

+
    +
  • HTTP Response Input Streams Will Throw an IOException on Interrupt (JDK-8294047) : http请求中断抛出异常
    • +
  • HttpClient Default Keep Alive Time is 30 Seconds (JDK-8297030) : 由java.net.http.HttpClient创建的HTTP/1.1和HTTP/2连接的默认空闲连接超时值已从1200秒减少到30秒
    • +
  • Idle Connection Timeouts for HTTP/2 (JDK-8288717) : 此版本中添加了HTTP/2的空闲连接超时。
    • +
  • FileChannel Positional Write Is Unspecified in APPEND Mode (JDK-6924219) : append模式下,FileChannel写入位置因操作系统而定
    • +
  • Update Timezone Data to 2022c (JDK-8292579) : 此版本包括2022b的更改，将1970年后具有相同时间戳数据的多个区域合并到单个时区数据库中。所有时区ID保持不变，但合并的时区将指向共享区域数据库。
    • +
  • IdentityHashMap’s Remove and Replace Methods Use Object Identity (JDK-8178355) : IdentityHashMap的这两个方法, 对象比较由 equals 改为 ==
    • +
  • Support for CLDR Version 42 (JDK-8284840) : 基于Unicode Consortium的CLDR的本地数据已升级到版本42
    • +
  • Introduce LDAP and RMI Protocol Specific Object Factory Filters to JNDI Implementation (JDK-8290368) : 引入了新的系统和安全属性，以允许对允许从JNDI/LDAP和JNDI/RMI上下文重建Java对象的JNDI对象工厂集进行更精细的控制
    • +
  • G1: Disable Preventive GCs by Default (JDK-8293861) : G1默认禁用Preventive垃圾回收器
    • +
  • appendToClassPathForInstrumentation Must Be Used in a Thread-Safe Manner (JDK-8296472) : 如题, 当时用java agent时,自定义类加载器中的appendToClassPathForInstrumentation方法必须以线程安全的方式添加到类搜索路径中。
    • +
  • Deprecate and Disable Legacy Parallel Class Loading Workaround for Non-Parallel-Capable Class Loaders (JDK-8295673) : 一些用户定义的旧类加载器会通过在加载过程中释放类加载器锁来解决死锁问题。为了防止这些加载程序在通过并行线程加载同一类时遇到“java.lang.LinkageError：尝试重复类定义”，HotSpot虚拟机在JDK 6中引入了一种变通方法，将加载尝试序列化，导致随后的尝试等待第一个完成. 现在将这种变通 方法废弃了
    • +
  • Disabled DTLS 1.0 (JDK-8256660) : 废弃 DTLS 1.0
    • +
  • Remove Thread Text from Subject.current (JDK-8297276) : 在此版本中，Subject.current的规范已更改，以降低创建线程时继承主题的期望。此时，主题存储在AccessControlContext中，并在创建平台线程时被继承。虚拟线程在线程创建时不会捕获调用者上下文，并且不会继承AccessControlContext。在删除对SecurityManager和继承的AccessControlContext的支持之前，将在未来的版本中重新审查继承。
    • +
  • Generalize ‘see’ and ‘link’ Tags for User-Defined Anchors (JDK-8200337) : {@link}、{@linkplain}和@see标签已增强，允许链接到JavaDoc生成的元素文档中的任意锚点。为了区分这些引用和成员引用，使用双散列标记（##）将元素名称与URI片段分开。
    • +
+

名词解析

    +

  • HarfBuzz: 一个开源的用于文字塑形的软件开发库，亦即用于转换Unicode文本到字形指标及方位的过程

    +
    • +

  • FreeType: 同HarfBuzz一样, 也是一个开源字体库. 它是一个用C语言实现的一个字体光栅化库。它可以用来将字符栅格化并映射成位图以及提供其他字体相关业务的支持

    +
    • +

  • Preview(预览): 功能已经基本完整, 可以试用了. 可以简单理解为beta公测版. 来源于 JEP12

    +
    +

    功能以预览版的形式发布，以收集有关它们的反馈而不承诺保持其向后兼容性——这意味着鼓励每个人尝试它们，但同时不鼓励在生产中使用它们。

    +

    预览功能不是开箱即用的，为了访问它们，需要使用*–enable-preview*编译器标志。

    +
    +
    • +

  • Incubator(孵化) : 实验性 API已经到了一定阶段, 已经计划开发出一整套完整的功能.以独立模块的形式发布. 来源于 JEP11

    +
    • +

  • Experimental(实验) : vm级的早期功能, 不稳定, 功能不完整. 实验性质.

    +
    +

    实验性功能代表（主要是）VM 级功能的早期版本，这些功能可能是有风险的、不完整的，甚至是不稳定的。在大多数情况下，需要使用专用标志启用它们

    +

    出于比较的目的，如果一个实验功能被认为是 25%“完成”，那么一个预览功能应该至少 95%“完成”。

    +

    预览,孵化,实验三者的关系大致: 实验 => 孵化 => 预览 => 合并jdk主体功能.

    +
    +
    • +

  • JEP : JDK Enhancement Proposal , jdk增强建议. 也就是我们常说的jdk新特性的来源. JEP大全

    +
    • +
+

往期文章

jdk19新特性

+

参考文章

jdk20官方文档
jdk20新特性文档
jdk20升级指南
jdk20安装指南
jdk20的开发计划
jdk20虚拟机简介
jdk20垃圾回收机制
jdk20安全机制

+

openjdk bug反馈系统
openjdk官网
jdk中预览,实验,孵化的关系

+ + +
+ +
+
+
+ +
+ + + + + + + + + + java + + + > + + java版本特性 + + + + + + + + + + +
+ + +
+ + + #java + +
+ +
+ + + + + +
+
+
JDK 20新特性简介
+
https://www.hancher.top/2023/04/04/java-jdk-v20/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年4月4日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/04/20/bash-shc/index.html b/2023/04/20/bash-shc/index.html new file mode 100644 index 00000000..d2ec1f47 --- /dev/null +++ b/2023/04/20/bash-shc/index.html @@ -0,0 +1,789 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如何给bash脚本进行加密？ - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

如何给bash脚本进行加密？

+ + +
+ +

当我们写的bash脚本，有的时候需要分享给别人用，但是又不太想让别人看到实现逻辑。没到这个时候，就想着要是能给这个脚本加密一下就好了。
仅加密脚本的内容，又不影响脚本的运行，多好。要知道在计算机的世界，只有想不到，没有做不到！
你不是第一个遇到这个问题的人，而且有比你更有行动力的人把这个问题解决了。

+

今天我们就介绍两个工具来解决这个问题。

+

gzexe

mac系统上自带的一个工具，可以在mac系统上将一个可执行的bash脚本加密。
使用方式：

+
1
usage: gzexe [-d] file ...
+ +

我们以hello.sh 脚本为例。

+
1
2
#!/bin/bash
echo "Hello World "
+

操作：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
mac % gzexe hello.sh 
gzexe: cannot compress hello.sh, it is not executable # hello.sh 必须是一个可执行文件

# 修改hello.sh 为可执行文件
mac % chmod 744 hello.sh 

mac % gzexe hello.sh 
hello.sh:	   -4.3%  

# 成功，并且体检压缩了4.3% 我们执行一下ls 看看发生了什么
mac % ls
hello.sh	hello.sh~

# 这个时候我们发现hello.sh已经加密了，但我们发现多了一个hello.sh~文件。 这个就是我们的加密前的源文件。
# 源文件还在？我们把hello.sh~删了 ， 看看还不能运行。
mac % rm hello.sh~
mac % sh hello.sh 
Hello World # 依然可以运行
+

但是我们把hello.sh放到其他系统上执行时，会发现失败。但是在mac本地系统执行时，还是可以的.

+

shc (Shell Script Compiler)

shell(bash) 脚本编译指令。mac系统原生不支持，可以通过下面方式安装。

+

安装步骤

    +
  1. 检查本地是否装有shc， 直接输入shc命令
    2. +
  2. 安装
    3. +
+
1
2
3
4
5
# linux 
yum install shc

# mac
brew install shc
+ +

使用

使用方式：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mac % shc -h
shc Version 4.0.3, Generic Shell Script Compiler
shc GNU GPL Version 3 Md Jahidul Hamid <jahidulhamid@yahoo.com>
shc Usage: shc [-e date] [-m addr] [-i iopt] [-x cmnd] [-l lopt] [-o outfile] [-rvDSUHCABh] -f script

    -e %s  Expiration date in dd/mm/yyyy format [none]
    -m %s  Message to display upon expiration ["Please contact your provider"]
    -f %s  File name of the script to compile
    -i %s  Inline option for the shell interpreter i.e: -e
    -x %s  eXec command, as a printf format i.e: exec('%s',@ARGV);
    -l %s  Last shell option i.e: --
    -o %s  output filename
    -r     Relax security. Make a redistributable binary
    -v     Verbose compilation
    -S     Switch ON setuid for root callable programs [OFF]
    -D     Switch ON debug exec calls [OFF]
    -U     Make binary untraceable [no]
    -H     Hardening : extra security protection [no]
           Require bourne shell (sh) and parameters are not supported
    -C     Display license and exit
    -A     Display abstract and exit
    -B     Compile for busybox
    -h     Display help and exit
+

同样以hello.sh脚本为例

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 普通加密
mac % shc -v -f hello.sh
mac % ls 
hello.sh # 原始脚本	
hello.sh.x	# 可执行脚本
hello.sh.x.c # 可执行脚本c语音文件

# 设置过期时间的加密脚本
mac % shc -v -e 20/04/2023 -m "过期了" -f hello.sh -o hello_expir.sh 
shc -e Thu Apr 20 00:00:00 2023
shc -e Thu Apr 20 00:00:00 2023
shc shll=bash
shc [-i]=-c
shc [-x]=exec '%s' "$@"
shc [-l]=
shc opts=
shc: cc   hello.sh.x.c -o hello_expir.sh
shc: strip hello_expir.sh
shc: chmod ug=rwx,o=rx hello_expir.sh

# 查看结果
mac % ls 
hello.sh	hello.sh.x.c	hello_expir.sh

# 过期效果
mac % ./hello_expir.sh 
./hello_expir.sh: has expired!
过期了

+

同gzexe一样，加密后的脚本一样不支持跨平台运行，即使是编译成c语言的二进制脚本。因为可执行文件会依赖不同系统的动态链接库。

+

参考

gzexe 源码

+

gzexe examples

+

SHC-Shell-Compiler

+

shc官网

+ + +
+ +
+
+
+ +
+ + + + + + + + + + linux + + + + + + + + +
+ + +
+ + + #linux + + #bash + +
+ +
+ + + + + +
+
+
如何给bash脚本进行加密？
+
https://www.hancher.top/2023/04/20/bash-shc/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年4月20日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/04/28/exception-spring-http-form-too-big-err/index.html b/2023/04/28/exception-spring-http-form-too-big-err/index.html new file mode 100644 index 00000000..91071465 --- /dev/null +++ b/2023/04/28/exception-spring-http-form-too-big-err/index.html @@ -0,0 +1,775 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + spring服务form表单内容过大导致后端参数接收为null情况 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

spring服务form表单内容过大导致后端参数接收为null情况

+ + +
+ +

问题现状

今天开发遇到一个奇怪的问题，前端的form表单数据提交的时候，数据量比较小的时候，内容能正常保存。

+

当数据量达到1.6M的时候，后端就开始报npe异常，参数字段就开始接收不到了。

+

解决

经过排查，发现这个和编程无关。
springboot 默认集成了tomcat容器，tomcat对form表单的大小有限制，默认2M。

+

知道了问题所在，解决起来就很简单了。
方案1： 增加tomcat的form表单容量配置

+
1
server.tomcat.max-http-form-post-size=10MB
+

方案2：去掉tomcat的form容量配置

+
1
server.tomcat.max-http-form-post-size=-1
+ +

参考

spring官方配置

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + + + + + + +
+ + +
+ + + #java + + #异常 + + #spring + +
+ +
+ + + + + +
+
+
spring服务form表单内容过大导致后端参数接收为null情况
+
https://www.hancher.top/2023/04/28/exception-spring-http-form-too-big-err/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年4月28日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/05/21/spring-spring-path-matcher/index.html b/2023/05/21/spring-spring-path-matcher/index.html new file mode 100644 index 00000000..62a5ebdf --- /dev/null +++ b/2023/05/21/spring-spring-path-matcher/index.html @@ -0,0 +1,789 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + AntPathMatcher VS PathPattern - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

AntPathMatcher VS PathPattern

+ + +
+ +

spring路径匹配，在spring5以后，有了AntPathMatcher 和 PathPattern 两种方式。

+

PathPattern是在spring 5 以后新增的。本文就介绍 AntPathMatcher 和 PathPattern 的异同，以及这两者的使用场景和方式。

+

创建实例

AntPathMatcher在1.x版本就存在了，在spring5以前，一直作为spring的路径匹配器存在。

+

AntPathMatcher在spring中是作为工具类存在的，所以直接new对象即可。

+

PathPattern出现在spring5.x版本中, 旨在用于替换掉较为“古老”的AntPathMatcher。

+

PathPattern是spring一个内部类，不能通过public的方式来创建。不过spring 官方提供了一个parser开提供PathPattern的默认实例。

+
1
2
3
4
// 构建AntPathMatcher 实例
AntPathMatcher antPathMatcher = new AntPathMatcher();
// 构建PathPattern 实例
PathPatternParser patternParser = PathPatternParser.defaultInstance;
+ +

匹配规则

AntPathMatcher 官方文档：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
映射使用以下规则匹配 URL： 
? 匹配一个字符
* 匹配零个或多个字符
** 匹配路径中的零 个 或多个目录
{spring:[a-z]+} 将正则表达 [a-z]+ 式匹配为名为“spring”的路径变量
        
例子
com/t?st.jsp — 匹配 com/test.jsp ，但也 com/tast.jsp 匹配或 com/txst.jsp
com/*.jsp— 匹配目录中com的所有.jsp文件
com/**/test.jsp— 匹配路径下com的所有test.jsp文件
org/springframework/**/*.jsp— 匹配路径下org/springframework的所有.jsp文件
org/**/servlet/bla.jsp — 匹配 org/springframework/servlet/bla.jsp ，但也 org/springframework/testing/servlet/bla.jsp 和 org/servlet/bla.jsp
com/{filename:\\w+}.jsp将匹配com/test.jsp该值testfilename并将其分配给变量
注意： 模式和路径必须都是绝对的，或者必须都是相对的，才能使两者匹配。因此，建议此实现的用户清理模式，以便在使用模式的上下文中为“/”作为前缀。
+ +

PathPattern 官方文档

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
PathPattern 使用以下规则匹配 URL 路径： 
? 匹配一个字符
* 匹配路径段中的零个或多个字符
** 匹配零个或多个 路径段 ，直到路径结束
{spring} 匹配 路径段 并将其捕获为名为“spring”的变量
{spring:[a-z]+} 将正则表达 [a-z]+ 式匹配为名为“spring”的路径变量
{*spring} 匹配零个或多个 路径段 ，直到路径的末尾，并将其捕获为名为“spring”的变量
注意： 与 org.springframework.util.AntPathMatcher相反， ** 仅在模式的末尾受支持。例如 /pages/{**} ，是有效的，但不是 /pages/{**}/details 。这同样适用于捕获变体 {*spring}。目的是在比较模式的特异性时消除歧义。

例子
/pages/t?st.html — 匹配 /pages/test.html ， /pages/tXst.html 但不是 /pages/toast.html
/resources/*.png— 匹配目录中resources的所有.png文件
/resources/** — 匹配路径下 /resources/ 的所有文件，包括 /resources/image.png 和 /resources/css/spring.css
/resources/{*path} — 匹配 和 下的所有文件 /resources/， /resources并在名为 “path” 的变量中捕获它们的相对路径; /resources/image.png 将与 “path” 匹配 → “/image.png”，并将 /resources/css/spring.css 与 “path” 匹配 → “/css/spring.css”
/resources/{filename:\\w+}.dat将匹配/resources/spring.dat该值"spring"filename并将其分配给变量
+

可见，AntPathMatcher 和 PathPattern 的匹配规则是差不多的，都支持? * ** 已经部分正则匹配。

+

但PathPattern增加了路径匹配并提取结果的能力，同时为了消除歧义，不再支持路径中间的**匹配，其他一样。

+

demo:

+

*匹配

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
public class TestPathMatch {
    public static void main(String[] args) {
        AntPathMatcher antPathMatcher = new AntPathMatcher();
        PathPatternParser patternParser = PathPatternParser.defaultInstance;

        List<String> list = List.of("aaa_1.csv", "aaa_2.csv", "aaa_3.csv", "aaa_1.xlsx", "aaa", "aaa.pdf");
        String pattern1 = "a*.csv";

        System.out.println("by antPathMatcher..");
        for (String s : list) {
            System.out.printf("pattern %s match %s is %s %n", pattern1,s, antPathMatcher.match(pattern1,s));
        }
        System.out.println("by patternParser..");
        for (String s : list) {
            System.out.printf("pattern %s match %s is %s %n", pattern1,s, patternParser.parse(pattern1).matches(PathContainer.parsePath(s)));
        }
    }
}

// 结果
// by antPathMatcher..
// pattern a*.csv match aaa_1.csv is true
// pattern a*.csv match aaa_2.csv is true
// pattern a*.csv match aaa_3.csv is true
// pattern a*.csv match aaa_1.xlsx is false
// pattern a*.csv match aaa is false
// pattern a*.csv match aaa.pdf is false
// by patternParser..
// pattern a*.csv match aaa_1.csv is true
// pattern a*.csv match aaa_2.csv is true
// pattern a*.csv match aaa_3.csv is true
// pattern a*.csv match aaa_1.xlsx is false
// pattern a*.csv match aaa is false
// pattern a*.csv match aaa.pdf is false
+

PathPattern 路径提取

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public class TestPathMatch {
    public static void main(String[] args) {
        AntPathMatcher antPathMatcher = new AntPathMatcher();
        PathPatternParser patternParser = PathPatternParser.defaultInstance;

        String pattern = "/api/hancher/{*spring}";
        List<String> list = List.of("/api/hancher/a/b/c", "/api/hancher/a", "/api/hancher/a/", "/api/hancher/a/b/c.csv","/api/test/a/b/c");

        for (String s : list) {
            System.out.printf("pattern %s match %s is %s %n", pattern,s, patternParser.parse(pattern).matches(PathContainer.parsePath(s)));
            System.out.printf("pattern %s match %s result %s %n", pattern,s, patternParser.parse(pattern).matchAndExtract(PathContainer.parsePath(s)));
        }
    }
}

// 结果
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c is true 
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c result PathMatchInfo[uriVariables={spring=/a/b/c}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/hancher/a is true 
//pattern /api/hancher/{*spring} match /api/hancher/a result PathMatchInfo[uriVariables={spring=/a}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/hancher/a/ is true 
//pattern /api/hancher/{*spring} match /api/hancher/a/ result PathMatchInfo[uriVariables={spring=/a/}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c.csv is true 
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c.csv result PathMatchInfo[uriVariables={spring=/a/b/c.csv}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/test/a/b/c is false 
//pattern /api/hancher/{*spring} match /api/test/a/b/c result null
+ +

性能

官方说PathPattern 比 AntPathMatcher 更快一些，所以咱们验证一下：

+

测试代码

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public class TestPathMatch {
    public static void main(String[] args) {
        AntPathMatcher antPathMatcher = new AntPathMatcher();
        PathPatternParser patternParser = PathPatternParser.defaultInstance;

        long start = System.currentTimeMillis();
        String pattern = "/api/hanc?er/**";
        for (int i = 0; i < 100000; i++) {
            String path = "/api/hancher/" + i + "/" + i + "/a.txt";
            System.out.println(antPathMatcher.match(pattern, path));
//            System.out.println(patternParser.parse(pattern).matches(PathContainer.parsePath(path)));
        }
        System.out.println(System.currentTimeMillis() - start);
    }
}
+

分别跑了5次。
AntPathMatcher 平均耗时：392ms
PathPattern 平均耗时：323.4ms
官方所言不虚！

+

选择

    +
  1. 在满足需求的情况下，尽量选PathPattern，更快
    2. +
  2. 如果需要通过*匹配中间路径，或者通过匹配文件扩展名这种场景，用AntPathMatcher， 因为PathPattern不支持。
    3. +
+ + +
+ +
+
+
+ +
+ + + + + + + + + + spring + + + + + + + + +
+ + +
+ + + #spring + +
+ +
+ + + + + +
+
+
AntPathMatcher VS PathPattern
+
https://www.hancher.top/2023/05/21/spring-spring-path-matcher/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年5月21日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/06/19/safe-dev-info-leak/index.html b/2023/06/19/safe-dev-info-leak/index.html new file mode 100644 index 00000000..ac063162 --- /dev/null +++ b/2023/06/19/safe-dev-info-leak/index.html @@ -0,0 +1,785 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 中间件版本号泄露问题修复 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

中间件版本号泄露问题修复

+ + +
+ +

开发过程中的一些信息带到了线上，要及时修复，不如坏人就顺藤摸瓜找来了。

+

以下是漏洞的一些内容：

+

安全漏洞描述

信息泄露主要是由于开发人员或运维管理人员的疏忽所导致。如未及时删除调试页面、未关闭程序调试功能、未屏蔽程序错误信息、备份文件未删除、数据库备份文件未删除、未屏蔽敏感数据信息等多个方面所导致的不同严重程度的信息泄露。攻击者可通过所掌握的信息进一步分析攻击目标，从而有效发起下一步的有效攻击。

+

常见的问题有：

+
    +
  1. swagger 接口未关闭
    2. +
  2. druid监控台未关闭
    3. +
  3. 等
    4. +
+

风险等级：低

解决办法

关闭相关接口的线上权限，或增加权限控制

+

1，swagger 关闭入口的方式
方法a: 使用注解 @Value() 推荐使用， 然后在不同的配置文件里指定开关

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
@Value("${swagger.enabled}")
private boolean enabled;

@Bean
public Docket createRestApi()
{
    return new Docket(DocumentationType.V1)
            // 是否启用Swagger           
             .enable(enabled)
            // 用来创建该API的基本信息，展示在文档的页面中（自定义展示的信息）            
            .apiInfo(apiInfo())
            // 设置哪些接口暴露给Swagger展示           
             .select()
            // 扫描所有有注解的api，用这种方式更灵活           
             .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
            // 扫描指定包中的swagger注解            
            // .apis(RequestHandlerSelectors.basePackage("com.ruoyi.project.tool.swagger"))           
             // 扫描所有 .apis(RequestHandlerSelectors.any())            
             .paths(PathSelectors.any())
            .build()
            /* 设置安全模式，swagger可以设置访问token */          
            .securitySchemes(securitySchemes())
            .securityContexts(securityContexts())
            .pathMapping(pathMapping);
}
+

方法b: 使用注解@Profile({“dev”,“test”}) 表示在开发或测试环境开启，而在生产关闭
swagger-switch
其实ab 的方式是一样的，都是不同的环境开关不同。

+

2， druid关闭监控台的方式

+
1
2
spring.datasource.druid.webStatFilter.enabled=false
spring.datasource.druid.statViewServlet.enabled=false
+ +

3， 一些其他接口增加权限认证
通过spring的httpSecurity 增加路径鉴权

+
1
2
3
4
5
6
protected void configure(HttpSecurity httpSecurity) throws Exception {
    // something
    // druid 接口要鉴权
    httpSecurity..antMatchers("/druid/**").authenticated()
    // something
}
+ + +

安全无小事！！！

+ +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #spring + + #安全 + +
+ +
+ + + + + +
+
+
中间件版本号泄露问题修复
+
https://www.hancher.top/2023/06/19/safe-dev-info-leak/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年6月19日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/06/20/safe-http-any-file-download/index.html b/2023/06/20/safe-http-any-file-download/index.html new file mode 100644 index 00000000..9db2ac75 --- /dev/null +++ b/2023/06/20/safe-http-any-file-download/index.html @@ -0,0 +1,785 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 网站任意文件下载或读取 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

网站任意文件下载或读取

+ + +
+ +

项目中下载方法没有安全校验，导致脚本注入，可以下载服务器任意路径下的文件。
对此总结了一下修复办法，方便大家参考，修复。

+

以下是漏洞的一些内容：

+

安全漏洞描述

任意文件下载或读取漏洞主要是由于应用系统在提供文件下载或读取功能时，在文件路径参数中直接指定文件路径的同时并没有对文件路径的合法性进行校验，
导致攻击者可通过目录跳转(..\或../)的方式下载或读取到原始指定路径之外的文件。
攻击者最终可通过该漏洞下载或读取系统上的任意文件，如数据库文件、应用系统源代码、密码配置信息等重要敏感信息，造成系统的敏感信息泄露。

+

重现方法

对存在文件下载或文件读取功能的页面进行测试，查看所提交的参数中是否包含文件名或文件目录，尝试提交参数值查看是否可下载或读取其他目录的文件内容；

+

如：

+

原始下载功能路径为
http://www.example.com/donwload.jsp?filename=test123456789.pdf

+

其中文件路径参数为filename，通过../对路径进行跳转尝试下载其他目录下的文件，修改filename参数为../../WEB-INF/web.xml尝试下载JSP网站的配置文件（测试过程中需适当增加../跳转字符串）；如提交
http://www.example.com/donwload.jsp?filename=../../WEB-INF/web.xml

+

查看是否成功下载web.xml文件。

+

另一种情况如下：
http://www.example.com/donwload.jsp?filepath=uploadfile&filename=test123.pdf
该功能通过filepath以及filename指定下载目录以及下载文件名，可修改filepath参数值进行路径跳转，
同时修改filename值指定文件名；如提交
http://www.example.com/donwload.jsp?filepath=../../WEB-INF&filename=web.xml

+

查看是否成功下载web.xml文件。

+

风险等级：高

解决办法

知道了问题，一般可以通过在代码层级增加关键字符过滤来修复。
比如：

+
    +
  1. 对path参数进行过滤，依次过滤“.”、“..”、“/”、“”等字符。
    2. +
  2. 或者对于下载文件的目录做好限制，只能下载指定目录下的文件，
    3. +
  3. 或者将要下载的资源文件路径存入数据库，附件下载时指定数据库中的id即可，id即对应的资源。
    服务器级建议
    4. +
+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
private Pair<Boolean,String> checkFileAttack(String filePath) {
    if (StringUtils.isEmpty(filePath)) {
        return Pair.of(false, "文件名为空");
    }

    if (filePath.startsWith("/")) {
        return Pair.of(false, "文件名不能以/开始");
    }

    // 禁止文件名中包含  “%00”，“..”，“./”，“#/” ，"~/" , "^/"    Pattern pattern = Pattern.compile("(\\.\\.|~/|^/|\\./|#/|%00)");
    if (pattern.matcher(filePath).matches()) {
        return Pair.of(false, "文件名不合法");
    }

    if (!ArrayUtils.contains(MimeTypeUtils.DEFAULT_ALLOWED_EXTENSION, FileTypeUtils.getFileType(filePath)))
    {
        return Pair.of(false, "非法格式");
    }

    return Pair.of(true, "校验成功");
}
+ +

或者，在服务部署的时候，通过下面的目录固化部署路径，令web请求不能逃逸到整个服务器。

+
    +
  • 使用chroot 命令，固化服务路径
    • +
+

安全无小事！！！

+ +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #spring + + #安全 + +
+ +
+ + + + + +
+
+
网站任意文件下载或读取
+
https://www.hancher.top/2023/06/20/safe-http-any-file-download/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年6月20日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/06/20/safe-http-url-header-attack/index.html b/2023/06/20/safe-http-url-header-attack/index.html new file mode 100644 index 00000000..d171230f --- /dev/null +++ b/2023/06/20/safe-http-url-header-attack/index.html @@ -0,0 +1,785 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + URL存在http host头攻击漏洞的解决办法 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

URL存在http host头攻击漏洞的解决办法

+ + +
+ +

项目中遇到http host头攻击的解决办法，支持nginx，apache 两种办法。

+

以下是漏洞的一些内容：

+

安全漏洞描述

为了方便的获得网站域名，开发人员一般依赖于HTTP Host header。例如，在php里用_SERVER[“HTTP_HOST”]。
但是这个header是不可信赖的，如果应用程序没有对host header值进行处理，就有可能造成恶意代码的传入。

+

http-host-attack

+

风险等级：高

解决办法

web应用程序应该使用SERVER_NAME而不是host header。 在Apache和Nginx里可以通过设置一个虚拟机来记录所有的非法host header。
在Nginx里还可以通过指定一个SERVER_NAME名单，Apache也可以通过指定一个SERVER_NAME名单并开启UseCanonicalName选项。

+

本质上就是在服务侧鉴定请求来源， 非法来源直接过滤掉。

+

nginx 解决方案

打开nginx的网站配置文件，一般为 /etc/nginx/conf.d/xxx.conf
添加如下配置

+
1
2
3
4
5
6
7
8
9
server {
    listen       80;
    server_name  127.0.0.1;
    # 防止http host 攻击的配置： 仅允许 指定域名访问，其他域名返回403
    if ($http_Host !~* ^domain.com|127.0.0.1:80$) {
        return 403;
    }
    # 其他配置
}
+ +

重启nginx即可

+
1
nginx -s reload
+ +

Apache解决方案

打开Apache的配置 ， 一般为 /conf/httpd.conf
添加如下配置：

+
1
2
3
4
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www.domain.com$ [NC]
RewriteRule ^(.*)$ /403.html

+

重启apache即可

+

安全无小事！！！

Web漏洞之HOST头攻击

+

host头攻击

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #nginx + + #安全 + + #apache + +
+ +
+ + + + + +
+
+
URL存在http host头攻击漏洞的解决办法
+
https://www.hancher.top/2023/06/20/safe-http-url-header-attack/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年6月20日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/06/21/safe-cors-attack/index.html b/2023/06/21/safe-cors-attack/index.html new file mode 100644 index 00000000..0c77ed32 --- /dev/null +++ b/2023/06/21/safe-cors-attack/index.html @@ -0,0 +1,775 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CORS跨域攻击与修复 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

CORS跨域攻击与修复

+ + +
+ +

CORS跨域的逆向操作，如何收回放开的跨域权限。

+

以下是CORS漏洞的一些内容：

+

安全漏洞描述

Web服务端CORS（跨域资源共享）错误配置，无法正确验证Origin头，任何网站都可以发出使用用户凭据发出的请求，并读取对这些请求的响应，信任任意来源可以有效地禁用同源策略，从而允许第三方网站进行双向交互，易导致敏感信息泄露

+

swagger-switch

+

风险等级：高

解决办法

需要修复两处：
1，代码级别（必修）
程序默认是禁止跨域的，也可以去掉相关逻辑。

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// 比如： *.domain.com, 127.0.0.1  
@Value("${cros.allow-origin:*}")
private String crosAllowOrigin;

@Bean
public CorsFilter corsFilter()
{
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowCredentials(false);
    // 设置访问源地址，   
    for (String origin : crosAllowOrigin.split(",")) {
        config.addAllowedOriginPattern(origin);
    }
    // 设置访问源请求头 , 也可以配置  
    config.addAllowedHeader("*");
    // 设置访问源请求方法 , 也可以配置   
    config.addAllowedMethod("*");
    // 有效期 1800秒    
    config.setMaxAge(1800L);
    // 添加映射路径，拦截一切请求    
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/**", config);
    // 返回新的CorsFilter    
    return new CorsFilter(source);
}
+

2，nginx服务
增加相关头配置

+
1
add_header Access-Control-Allow-Origin your.domain.com;
+ + +

安全无小事！！！

+ +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #spring + + #安全 + +
+ +
+ + + + + +
+
+
CORS跨域攻击与修复
+
https://www.hancher.top/2023/06/21/safe-cors-attack/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年6月21日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/06/21/safe-xss-reactive/index.html b/2023/06/21/safe-xss-reactive/index.html new file mode 100644 index 00000000..e9af663a --- /dev/null +++ b/2023/06/21/safe-xss-reactive/index.html @@ -0,0 +1,781 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 存储XSS问题与修复 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

存储XSS问题与修复

+ + +
+ +

安全漏洞描述

恶意攻击者往Web页面里插入恶意Script代码，当用户浏览该页时，嵌入其中Web里面的Script代码会被执行，进而窃取到管理员用户权限等。

+

风险等级：高

解决办法

    +
  1. 对网页端输入的特殊字符过滤
    建议过滤的关键字为：
    [1]’单引号
    [2]”双引号
    [3]/斜杠
    [4]反斜杠
    [5])括号
    [6];分号
    [7][中括号
    [8]<尖括号
    [9]>尖括号
    比如把<编码为<
    2. +
  2. 在cookie中加入httponly属性可以在一定程度上保护用户的cookie，减少出现XSS时损失。
    3. +
+

一段简易的字符过滤程序

+
1
2
3
4
5
6
7
8
9
10
function htmlEncode(str){
    var s = "";
    if (str.length == 0) return "";
    s = str.replace(/&/g, "&");
    s = s.replace(//g, ">");
    s = s.replace(/ /g, " ");
    s = s.replace(/\'/g, "'");
    s = s.replace(/\"/g, """);
    return s;
}
+ +
    +
  1. 在服务端增加filter过滤
    通过自定义filter的方式拦截过滤请求
    2. +
+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
public class XssFilter implements Filter
{
    /**
     * 排除链接
     */
    public List<String> excludes = new ArrayList<>();

    @Override
    public void init(FilterConfig filterConfig) throws ServletException
    {
        String tempExcludes = filterConfig.getInitParameter("excludes");
        if (StringUtils.isNotEmpty(tempExcludes))
        {
            String[] url = tempExcludes.split(",");
            for (int i = 0; url != null && i < url.length; i++)
            {
                excludes.add(url[i]);
            }
        }
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException
    {
        HttpServletRequest req = (HttpServletRequest) request;
        HttpServletResponse resp = (HttpServletResponse) response;
        if (handleExcludeURL(req, resp))
        {
            chain.doFilter(request, response);
            return;
        }
        XssHttpServletRequestWrapper xssRequest = new XssHttpServletRequestWrapper((HttpServletRequest) request);
        chain.doFilter(xssRequest, response);
    }

    private boolean handleExcludeURL(HttpServletRequest request, HttpServletResponse response)
    {
        String url = request.getServletPath();
        String method = request.getMethod();
        // GET DELETE 不过滤
        if (method == null || HttpMethod.GET.matches(method) || HttpMethod.DELETE.matches(method))
        {
            return true;
        }
        return StringUtils.matches(url, excludes);
    }
}
+

在wrapper里过滤参数

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
public class XssHttpServletRequestWrapper extends HttpServletRequestWrapper
{
    /**
     * @param request
     */
    public XssHttpServletRequestWrapper(HttpServletRequest request)
    {
        super(request);
    }

    @Override
    public String[] getParameterValues(String name)
    {
        String[] values = super.getParameterValues(name);
        if (values != null)
        {
            int length = values.length;
            String[] escapesValues = new String[length];
            for (int i = 0; i < length; i++)
            {
                // 防xss攻击和过滤前后空格
                escapesValues[i] = EscapeUtil.clean(values[i]).trim();
            }
            return escapesValues;
        }
        return super.getParameterValues(name);
    }

    @Override
    public ServletInputStream getInputStream() throws IOException
    {
        // 非json类型，直接返回
        if (!isJsonRequest())
        {
            return super.getInputStream();
        }

        // 为空，直接返回
        String json = IOUtils.toString(super.getInputStream(), "utf-8");
        if (StringUtils.isEmpty(json))
        {
            return super.getInputStream();
        }

        // xss过滤
        json = EscapeUtil.clean(json).trim();
        byte[] jsonBytes = json.getBytes("utf-8");
        final ByteArrayInputStream bis = new ByteArrayInputStream(jsonBytes);
        return new ServletInputStream()
        {
            @Override
            public boolean isFinished()
            {
                return true;
            }

            @Override
            public boolean isReady()
            {
                return true;
            }

            @Override
            public int available() throws IOException
            {
                return jsonBytes.length;
            }

            @Override
            public void setReadListener(ReadListener readListener)
            {
            }

            @Override
            public int read() throws IOException
            {
                return bis.read();
            }
        };
    }

    /**
     * 是否是Json请求
     * 
     * @param request
     */
    public boolean isJsonRequest()
    {
        String header = super.getHeader(HttpHeaders.CONTENT_TYPE);
        return StringUtils.startsWithIgnoreCase(header, MediaType.APPLICATION_JSON_VALUE);
    }
}
+

xssUtil

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
public class EscapeUtil
{
    public static final String RE_HTML_MARK = "(<[^<]*?>)|(<[\\s]*?/[^<]*?>)|(<[^<]*?/[\\s]*?>)";

    private static final char[][] TEXT = new char[64][];

    static
    {
        for (int i = 0; i < 64; i++)
        {
            TEXT[i] = new char[] { (char) i };
        }

        // special HTML characters
        TEXT['\''] = "&#039;".toCharArray(); // 单引号
        TEXT['"'] = "&#34;".toCharArray(); // 双引号
        TEXT['&'] = "&#38;".toCharArray(); // &符
        TEXT['<'] = "&#60;".toCharArray(); // 小于号
        TEXT['>'] = "&#62;".toCharArray(); // 大于号
    }

    /**
     * 转义文本中的HTML字符为安全的字符
     * 
     * @param text 被转义的文本
     * @return 转义后的文本
     */
    public static String escape(String text)
    {
        return encode(text);
    }

    /**
     * 还原被转义的HTML特殊字符
     * 
     * @param content 包含转义符的HTML内容
     * @return 转换后的字符串
     */
    public static String unescape(String content)
    {
        return decode(content);
    }

    /**
     * 清除所有HTML标签，但是不删除标签内的内容
     * 
     * @param content 文本
     * @return 清除标签后的文本
     */
    public static String clean(String content)
    {
        return new HTMLFilter().filter(content);
    }

    /**
     * Escape编码
     * 
     * @param text 被编码的文本
     * @return 编码后的字符
     */
    private static String encode(String text)
    {
        if (StringUtils.isEmpty(text))
        {
            return StringUtils.EMPTY;
        }

        final StringBuilder tmp = new StringBuilder(text.length() * 6);
        char c;
        for (int i = 0; i < text.length(); i++)
        {
            c = text.charAt(i);
            if (c < 256)
            {
                tmp.append("%");
                if (c < 16)
                {
                    tmp.append("0");
                }
                tmp.append(Integer.toString(c, 16));
            }
            else
            {
                tmp.append("%u");
                if (c <= 0xfff)
                {
                    // issue#I49JU8@Gitee
                    tmp.append("0");
                }
                tmp.append(Integer.toString(c, 16));
            }
        }
        return tmp.toString();
    }

    /**
     * Escape解码
     * 
     * @param content 被转义的内容
     * @return 解码后的字符串
     */
    public static String decode(String content)
    {
        if (StringUtils.isEmpty(content))
        {
            return content;
        }

        StringBuilder tmp = new StringBuilder(content.length());
        int lastPos = 0, pos = 0;
        char ch;
        while (lastPos < content.length())
        {
            pos = content.indexOf("%", lastPos);
            if (pos == lastPos)
            {
                if (content.charAt(pos + 1) == 'u')
                {
                    ch = (char) Integer.parseInt(content.substring(pos + 2, pos + 6), 16);
                    tmp.append(ch);
                    lastPos = pos + 6;
                }
                else
                {
                    ch = (char) Integer.parseInt(content.substring(pos + 1, pos + 3), 16);
                    tmp.append(ch);
                    lastPos = pos + 3;
                }
            }
            else
            {
                if (pos == -1)
                {
                    tmp.append(content.substring(lastPos));
                    lastPos = content.length();
                }
                else
                {
                    tmp.append(content.substring(lastPos, pos));
                    lastPos = pos;
                }
            }
        }
        return tmp.toString();
    }
}


public final class HTMLFilter
{
   /**
    * regex flag union representing /si modifiers in php
    **/
   private static final int REGEX_FLAGS_SI = Pattern.CASE_INSENSITIVE | Pattern.DOTALL;
   private static final Pattern P_COMMENTS = Pattern.compile("<!--(.*?)-->", Pattern.DOTALL);
   private static final Pattern P_COMMENT = Pattern.compile("^!--(.*)--$", REGEX_FLAGS_SI);
   private static final Pattern P_TAGS = Pattern.compile("<(.*?)>", Pattern.DOTALL);
   private static final Pattern P_END_TAG = Pattern.compile("^/([a-z0-9]+)", REGEX_FLAGS_SI);
   private static final Pattern P_START_TAG = Pattern.compile("^([a-z0-9]+)(.*?)(/?)$", REGEX_FLAGS_SI);
   private static final Pattern P_QUOTED_ATTRIBUTES = Pattern.compile("([a-z0-9]+)=([\"'])(.*?)\\2", REGEX_FLAGS_SI);
   private static final Pattern P_UNQUOTED_ATTRIBUTES = Pattern.compile("([a-z0-9]+)(=)([^\"\\s']+)", REGEX_FLAGS_SI);
   private static final Pattern P_PROTOCOL = Pattern.compile("^([^:]+):", REGEX_FLAGS_SI);
   private static final Pattern P_ENTITY = Pattern.compile("&#(\\d+);?");
   private static final Pattern P_ENTITY_UNICODE = Pattern.compile("&#x([0-9a-f]+);?");
   private static final Pattern P_ENCODE = Pattern.compile("%([0-9a-f]{2});?");
   private static final Pattern P_VALID_ENTITIES = Pattern.compile("&([^&;]*)(?=(;|&|$))");
   private static final Pattern P_VALID_QUOTES = Pattern.compile("(>|^)([^<]+?)(<|$)", Pattern.DOTALL);
   private static final Pattern P_END_ARROW = Pattern.compile("^>");
   private static final Pattern P_BODY_TO_END = Pattern.compile("<([^>]*?)(?=<|$)");
   private static final Pattern P_XML_CONTENT = Pattern.compile("(^|>)([^<]*?)(?=>)");
   private static final Pattern P_STRAY_LEFT_ARROW = Pattern.compile("<([^>]*?)(?=<|$)");
   private static final Pattern P_STRAY_RIGHT_ARROW = Pattern.compile("(^|>)([^<]*?)(?=>)");
   private static final Pattern P_AMP = Pattern.compile("&");
   private static final Pattern P_QUOTE = Pattern.compile("\"");
   private static final Pattern P_LEFT_ARROW = Pattern.compile("<");
   private static final Pattern P_RIGHT_ARROW = Pattern.compile(">");
   private static final Pattern P_BOTH_ARROWS = Pattern.compile("<>");

   // @xxx could grow large... maybe use sesat's ReferenceMap
   private static final ConcurrentMap<String, Pattern> P_REMOVE_PAIR_BLANKS = new ConcurrentHashMap<>();
   private static final ConcurrentMap<String, Pattern> P_REMOVE_SELF_BLANKS = new ConcurrentHashMap<>();

   /**
    * set of allowed html elements, along with allowed attributes for each element
    **/
   private final Map<String, List<String>> vAllowed;
   /**
    * counts of open tags for each (allowable) html element
    **/
   private final Map<String, Integer> vTagCounts = new HashMap<>();

   /**
    * html elements which must always be self-closing (e.g. "<img />")
    **/
   private final String[] vSelfClosingTags;
   /**
    * html elements which must always have separate opening and closing tags (e.g. "<b></b>")
    **/
   private final String[] vNeedClosingTags;
   /**
    * set of disallowed html elements
    **/
   private final String[] vDisallowed;
   /**
    * attributes which should be checked for valid protocols
    **/
   private final String[] vProtocolAtts;
   /**
    * allowed protocols
    **/
   private final String[] vAllowedProtocols;
   /**
    * tags which should be removed if they contain no content (e.g. "<b></b>" or "<b />")
    **/
   private final String[] vRemoveBlanks;
   /**
    * entities allowed within html markup
    **/
   private final String[] vAllowedEntities;
   /**
    * flag determining whether comments are allowed in input String.
    */
   private final boolean stripComment;
   private final boolean encodeQuotes;
   /**
    * flag determining whether to try to make tags when presented with "unbalanced" angle brackets (e.g. "<b text </b>"
    * becomes "<b> text </b>"). If set to false, unbalanced angle brackets will be html escaped.
    */
   private final boolean alwaysMakeTags;

   /**
    * Default constructor.
    */
   public HTMLFilter()
   {
      vAllowed = new HashMap<>();

      final ArrayList<String> a_atts = new ArrayList<>();
      a_atts.add("href");
      a_atts.add("target");
      vAllowed.put("a", a_atts);

      final ArrayList<String> img_atts = new ArrayList<>();
      img_atts.add("src");
      img_atts.add("width");
      img_atts.add("height");
      img_atts.add("alt");
      vAllowed.put("img", img_atts);

      final ArrayList<String> no_atts = new ArrayList<>();
      vAllowed.put("b", no_atts);
      vAllowed.put("strong", no_atts);
      vAllowed.put("i", no_atts);
      vAllowed.put("em", no_atts);

      vSelfClosingTags = new String[] { "img" };
      vNeedClosingTags = new String[] { "a", "b", "strong", "i", "em" };
      vDisallowed = new String[] {};
      vAllowedProtocols = new String[] { "http", "mailto", "https" }; // no ftp.
      vProtocolAtts = new String[] { "src", "href" };
      vRemoveBlanks = new String[] { "a", "b", "strong", "i", "em" };
      vAllowedEntities = new String[] { "amp", "gt", "lt", "quot" };
      stripComment = true;
      encodeQuotes = true;
      alwaysMakeTags = false;
   }

   /**
    * Map-parameter configurable constructor.
    *
    * @param conf map containing configuration. keys match field names.
    */
   @SuppressWarnings("unchecked")
   public HTMLFilter(final Map<String, Object> conf)
   {

      assert conf.containsKey("vAllowed") : "configuration requires vAllowed";
      assert conf.containsKey("vSelfClosingTags") : "configuration requires vSelfClosingTags";
      assert conf.containsKey("vNeedClosingTags") : "configuration requires vNeedClosingTags";
      assert conf.containsKey("vDisallowed") : "configuration requires vDisallowed";
      assert conf.containsKey("vAllowedProtocols") : "configuration requires vAllowedProtocols";
      assert conf.containsKey("vProtocolAtts") : "configuration requires vProtocolAtts";
      assert conf.containsKey("vRemoveBlanks") : "configuration requires vRemoveBlanks";
      assert conf.containsKey("vAllowedEntities") : "configuration requires vAllowedEntities";

      vAllowed = Collections.unmodifiableMap((HashMap<String, List<String>>) conf.get("vAllowed"));
      vSelfClosingTags = (String[]) conf.get("vSelfClosingTags");
      vNeedClosingTags = (String[]) conf.get("vNeedClosingTags");
      vDisallowed = (String[]) conf.get("vDisallowed");
      vAllowedProtocols = (String[]) conf.get("vAllowedProtocols");
      vProtocolAtts = (String[]) conf.get("vProtocolAtts");
      vRemoveBlanks = (String[]) conf.get("vRemoveBlanks");
      vAllowedEntities = (String[]) conf.get("vAllowedEntities");
      stripComment = conf.containsKey("stripComment") ? (Boolean) conf.get("stripComment") : true;
      encodeQuotes = conf.containsKey("encodeQuotes") ? (Boolean) conf.get("encodeQuotes") : true;
      alwaysMakeTags = conf.containsKey("alwaysMakeTags") ? (Boolean) conf.get("alwaysMakeTags") : true;
   }

   private void reset()
   {
      vTagCounts.clear();
   }

   // ---------------------------------------------------------------
   // my versions of some PHP library functions
   public static String chr(final int decimal)
   {
      return String.valueOf((char) decimal);
   }

   public static String htmlSpecialChars(final String s)
   {
      String result = s;
      result = regexReplace(P_AMP, "&amp;", result);
      result = regexReplace(P_QUOTE, "&quot;", result);
      result = regexReplace(P_LEFT_ARROW, "&lt;", result);
      result = regexReplace(P_RIGHT_ARROW, "&gt;", result);
      return result;
   }

   // ---------------------------------------------------------------

   /**
    * given a user submitted input String, filter out any invalid or restricted html.
    *
    * @param input text (i.e. submitted by a user) than may contain html
    * @return "clean" version of input, with only valid, whitelisted html elements allowed
    */
   public String filter(final String input)
   {
      reset();
      String s = input;

      s = escapeComments(s);

      s = balanceHTML(s);

      s = checkTags(s);

      s = processRemoveBlanks(s);

      // s = validateEntities(s);

      return s;
   }

   public boolean isAlwaysMakeTags()
   {
      return alwaysMakeTags;
   }

   public boolean isStripComments()
   {
      return stripComment;
   }

   private String escapeComments(final String s)
   {
      final Matcher m = P_COMMENTS.matcher(s);
      final StringBuffer buf = new StringBuffer();
      if (m.find())
      {
         final String match = m.group(1); // (.*?)
         m.appendReplacement(buf, Matcher.quoteReplacement("<!--" + htmlSpecialChars(match) + "-->"));
      }
      m.appendTail(buf);

      return buf.toString();
   }

   private String balanceHTML(String s)
   {
      if (alwaysMakeTags)
      {
         //
         // try and form html
         //
         s = regexReplace(P_END_ARROW, "", s);
         // 不追加结束标签
         s = regexReplace(P_BODY_TO_END, "<$1>", s);
         s = regexReplace(P_XML_CONTENT, "$1<$2", s);

      }
      else
      {
         //
         // escape stray brackets
         //
         s = regexReplace(P_STRAY_LEFT_ARROW, "&lt;$1", s);
         s = regexReplace(P_STRAY_RIGHT_ARROW, "$1$2&gt;<", s);

         //
         // the last regexp causes '<>' entities to appear
         // (we need to do a lookahead assertion so that the last bracket can
         // be used in the next pass of the regexp)
         //
         s = regexReplace(P_BOTH_ARROWS, "", s);
      }

      return s;
   }

   private String checkTags(String s)
   {
      Matcher m = P_TAGS.matcher(s);

      final StringBuffer buf = new StringBuffer();
      while (m.find())
      {
         String replaceStr = m.group(1);
         replaceStr = processTag(replaceStr);
         m.appendReplacement(buf, Matcher.quoteReplacement(replaceStr));
      }
      m.appendTail(buf);

      // these get tallied in processTag
      // (remember to reset before subsequent calls to filter method)
      final StringBuilder sBuilder = new StringBuilder(buf.toString());
      for (String key : vTagCounts.keySet())
      {
         for (int ii = 0; ii < vTagCounts.get(key); ii++)
         {
            sBuilder.append("</").append(key).append(">");
         }
      }
      s = sBuilder.toString();

      return s;
   }

   private String processRemoveBlanks(final String s)
   {
      String result = s;
      for (String tag : vRemoveBlanks)
      {
         if (!P_REMOVE_PAIR_BLANKS.containsKey(tag))
         {
            P_REMOVE_PAIR_BLANKS.putIfAbsent(tag, Pattern.compile("<" + tag + "(\\s[^>]*)?></" + tag + ">"));
         }
         result = regexReplace(P_REMOVE_PAIR_BLANKS.get(tag), "", result);
         if (!P_REMOVE_SELF_BLANKS.containsKey(tag))
         {
            P_REMOVE_SELF_BLANKS.putIfAbsent(tag, Pattern.compile("<" + tag + "(\\s[^>]*)?/>"));
         }
         result = regexReplace(P_REMOVE_SELF_BLANKS.get(tag), "", result);
      }

      return result;
   }

   private static String regexReplace(final Pattern regex_pattern, final String replacement, final String s)
   {
      Matcher m = regex_pattern.matcher(s);
      return m.replaceAll(replacement);
   }

   private String processTag(final String s)
   {
      // ending tags
      Matcher m = P_END_TAG.matcher(s);
      if (m.find())
      {
         final String name = m.group(1).toLowerCase();
         if (allowed(name))
         {
            if (!inArray(name, vSelfClosingTags))
            {
               if (vTagCounts.containsKey(name))
               {
                  vTagCounts.put(name, vTagCounts.get(name) - 1);
                  return "</" + name + ">";
               }
            }
         }
      }

      // starting tags
      m = P_START_TAG.matcher(s);
      if (m.find())
      {
         final String name = m.group(1).toLowerCase();
         final String body = m.group(2);
         String ending = m.group(3);

         // debug( "in a starting tag, name='" + name + "'; body='" + body + "'; ending='" + ending + "'" );
         if (allowed(name))
         {
            final StringBuilder params = new StringBuilder();

            final Matcher m2 = P_QUOTED_ATTRIBUTES.matcher(body);
            final Matcher m3 = P_UNQUOTED_ATTRIBUTES.matcher(body);
            final List<String> paramNames = new ArrayList<>();
            final List<String> paramValues = new ArrayList<>();
            while (m2.find())
            {
               paramNames.add(m2.group(1)); // ([a-z0-9]+)
               paramValues.add(m2.group(3)); // (.*?)
            }
            while (m3.find())
            {
               paramNames.add(m3.group(1)); // ([a-z0-9]+)
               paramValues.add(m3.group(3)); // ([^\"\\s']+)
            }

            String paramName, paramValue;
            for (int ii = 0; ii < paramNames.size(); ii++)
            {
               paramName = paramNames.get(ii).toLowerCase();
               paramValue = paramValues.get(ii);

               // debug( "paramName='" + paramName + "'" );
               // debug( "paramValue='" + paramValue + "'" );
               // debug( "allowed? " + vAllowed.get( name ).contains( paramName ) );

               if (allowedAttribute(name, paramName))
               {
                  if (inArray(paramName, vProtocolAtts))
                  {
                     paramValue = processParamProtocol(paramValue);
                  }
                  params.append(' ').append(paramName).append("=\\\"").append(paramValue).append("\\\"");
               }
            }

            if (inArray(name, vSelfClosingTags))
            {
               ending = " /";
            }

            if (inArray(name, vNeedClosingTags))
            {
               ending = "";
            }

            if (ending == null || ending.length() < 1)
            {
               if (vTagCounts.containsKey(name))
               {
                  vTagCounts.put(name, vTagCounts.get(name) + 1);
               }
               else
               {
                  vTagCounts.put(name, 1);
               }
            }
            else
            {
               ending = " /";
            }
            return "<" + name + params + ending + ">";
         }
         else
         {
            return "";
         }
      }

      // comments
      m = P_COMMENT.matcher(s);
      if (!stripComment && m.find())
      {
         return "<" + m.group() + ">";
      }

      return "";
   }

   private String processParamProtocol(String s)
   {
      s = decodeEntities(s);
      final Matcher m = P_PROTOCOL.matcher(s);
      if (m.find())
      {
         final String protocol = m.group(1);
         if (!inArray(protocol, vAllowedProtocols))
         {
            // bad protocol, turn into local anchor link instead
            s = "#" + s.substring(protocol.length() + 1);
            if (s.startsWith("#//"))
            {
               s = "#" + s.substring(3);
            }
         }
      }

      return s;
   }

   private String decodeEntities(String s)
   {
      StringBuffer buf = new StringBuffer();

      Matcher m = P_ENTITY.matcher(s);
      while (m.find())
      {
         final String match = m.group(1);
         final int decimal = Integer.decode(match).intValue();
         m.appendReplacement(buf, Matcher.quoteReplacement(chr(decimal)));
      }
      m.appendTail(buf);
      s = buf.toString();

      buf = new StringBuffer();
      m = P_ENTITY_UNICODE.matcher(s);
      while (m.find())
      {
         final String match = m.group(1);
         final int decimal = Integer.valueOf(match, 16).intValue();
         m.appendReplacement(buf, Matcher.quoteReplacement(chr(decimal)));
      }
      m.appendTail(buf);
      s = buf.toString();

      buf = new StringBuffer();
      m = P_ENCODE.matcher(s);
      while (m.find())
      {
         final String match = m.group(1);
         final int decimal = Integer.valueOf(match, 16).intValue();
         m.appendReplacement(buf, Matcher.quoteReplacement(chr(decimal)));
      }
      m.appendTail(buf);
      s = buf.toString();

      s = validateEntities(s);
      return s;
   }

   private String validateEntities(final String s)
   {
      StringBuffer buf = new StringBuffer();

      // validate entities throughout the string
      Matcher m = P_VALID_ENTITIES.matcher(s);
      while (m.find())
      {
         final String one = m.group(1); // ([^&;]*)
         final String two = m.group(2); // (?=(;|&|$))
         m.appendReplacement(buf, Matcher.quoteReplacement(checkEntity(one, two)));
      }
      m.appendTail(buf);

      return encodeQuotes(buf.toString());
   }

   private String encodeQuotes(final String s)
   {
      if (encodeQuotes)
      {
         StringBuffer buf = new StringBuffer();
         Matcher m = P_VALID_QUOTES.matcher(s);
         while (m.find())
         {
            final String one = m.group(1); // (>|^)
            final String two = m.group(2); // ([^<]+?)
            final String three = m.group(3); // (<|$)
            // 不替换双引号为&quot;，防止json格式无效 regexReplace(P_QUOTE, "&quot;", two)
            m.appendReplacement(buf, Matcher.quoteReplacement(one + two + three));
         }
         m.appendTail(buf);
         return buf.toString();
      }
      else
      {
         return s;
      }
   }

   private String checkEntity(final String preamble, final String term)
   {

      return ";".equals(term) && isValidEntity(preamble) ? '&' + preamble : "&amp;" + preamble;
   }

   private boolean isValidEntity(final String entity)
   {
      return inArray(entity, vAllowedEntities);
   }

   private static boolean inArray(final String s, final String[] array)
   {
      for (String item : array)
      {
         if (item != null && item.equals(s))
         {
            return true;
         }
      }
      return false;
   }

   private boolean allowed(final String name)
   {
      return (vAllowed.isEmpty() || vAllowed.containsKey(name)) && !inArray(name, vDisallowed);
   }

   private boolean allowedAttribute(final String name, final String paramName)
   {
      return allowed(name) && (vAllowed.isEmpty() || vAllowed.get(name).contains(paramName));
   }
}
+

前后端组合使用，可解决xss问题

+

安全无小事！！！

存储型XSS漏洞解决方案

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #spring + + #安全 + +
+ +
+ + + + + +
+
+
存储XSS问题与修复
+
https://www.hancher.top/2023/06/21/safe-xss-reactive/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年6月21日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/07/04/safe-mysql-jdbc-object-serial/index.html b/2023/07/04/safe-mysql-jdbc-object-serial/index.html new file mode 100644 index 00000000..cf957be5 --- /dev/null +++ b/2023/07/04/safe-mysql-jdbc-object-serial/index.html @@ -0,0 +1,780 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + jdbc反序列化漏洞修复 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

jdbc反序列化漏洞修复

+ + +
+ +

安全漏洞描述

Jdbc反序列化漏洞发生在后台代码使用mysql-connector组件连接数据库且攻击者可控制连接参数的情况下。攻击者可以构造恶意的mysql数据库使服务器去访问链接它从而触发反序列化漏洞导致命令执行

+

mysql 连接参数风险点：autoDeserialize，statementInterceptors

+

风险等级：高

解决办法

    +
  • 升级mysql版本到8.0.27+，官方已经修复此问题
    • +
+
1
2
3
4
5
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.27</version>
</dependency>
+ +
    +
  • 过滤掉风险参数
    一般情况下不需要对autoDeserialize和statementInterceptors参数进行设置。在后端代码设置连接字符参数白名单,或者将这两个参数直接替换掉。
    替换代码参考：
    • +
+
1
2
3
4
5
6
7
8
Properties prop = new Properties();
prop.put("autoDeserialize", "false");
prop.put("allowLoadLocalInfile", "false");
prop.put("allowUrlInLocalInfile", "false");
prop.put("allowLoadLocalInfileInPath", "");
prop.put("statementInterceptors", "");

Connectionconn=DriverManager.getConnection(DB_URL,prop);
+ + + +

安全无小事！！！

Jdbc反序列化漏洞复现浅析

+

探探JDBC反序列化漏洞

+

狼组-JDBC反序列化漏洞

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #mysql + + #安全 + +
+ +
+ + + + + +
+
+
jdbc反序列化漏洞修复
+
https://www.hancher.top/2023/07/04/safe-mysql-jdbc-object-serial/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年7月4日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/07/31/git-mirror/index.html b/2023/07/31/git-mirror/index.html new file mode 100644 index 00000000..d52bb87c --- /dev/null +++ b/2023/07/31/git-mirror/index.html @@ -0,0 +1,780 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + git优雅迁库的方式 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

git优雅迁库的方式

+ + +
+ +

在我们开发项目的时候，经常会遇到将一个git仓库迁移到一个新的git仓库的情况。 这个时候很多人会把原始的仓库最新代码复制到新库目录下，然后force push即可。

+

但是这样会产生一个问题，就是新库会把我们的历史提交记录等信息全部丢失了，当做一个全新的仓库来处理，这样给我们后续的问题追踪回溯带来了一些问题。

+

下面我们介绍一下git优雅迁库的三种方式。

+

裸库方式(推荐)

1
2
3
4
// 使用--bare克隆裸仓库
git clone --bare git@url1
// 推送到新库
git push  git@url2
+ +

镜像库方式

1
2
3
4
// 使用--mirror克隆裸仓库
git clone --mirror git@url1
// 推送到新库
git push  git@url2
+ +

镜像库是裸库的一种简写,等同于：

+
1
2
$ git clone --bare $URL
$ (cd $(basename $URL) && git remote add --mirror=fetch origin $URL)
+

由此可知，裸库方式clone下的是git仓库的基本信息。镜像库不仅把基本信息clone下来了，还拉去了最新的分支代码。

+

新增remote方式

1
2
git remote add origin2 [repo-url]
git push origin2
+ +

参考

git clone –mirror 和 –bare的区别

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + > + + git + + + + + + + + + + +
+ + +
+ + + #git + +
+ +
+ + + + + +
+
+
git优雅迁库的方式
+
https://www.hancher.top/2023/07/31/git-mirror/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年7月31日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/08/18/exception-java-oracle-docker-timezone-not-find/index.html b/2023/08/18/exception-java-oracle-docker-timezone-not-find/index.html new file mode 100644 index 00000000..749a6163 --- /dev/null +++ b/2023/08/18/exception-java-oracle-docker-timezone-not-find/index.html @@ -0,0 +1,789 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + java应用连接docker内的oracle时报ORA-01882错误 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

java应用连接docker内的oracle时报ORA-01882错误

+ + +
+ +

问题描述

数据库升级，用docker容器安装oracle11g数据库，应用连接的时候报ORA-01882错误

+
1
2
3
4
5
6
java.sql.SQLException: ORA-00604: error occurred at recursive SQL level 1
ORA-01882: timezone region not found

        at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:509)
        at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:456)
        at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:451)
+

环境：

+
    +
  • jdk ： openjdk8
    • +
  • oracle: 11g
    • +
+

解决

问题本质上是java应用程序启动时, 找不到本地系统的时区环境变量导致。 我们只有把时区环境变量配置上就可以了。

+

解决办法有二：

+
    +
  1. java应用程序启动时增加环境变量配置
    2. +
+
1
-Duser.timezone=xxx（xxx为oracle时区ID）
+ +
    +
  1. 直接修改服务器的系统环境变量（更彻底）
    2. +
+
1
2
3
4
# 时间更新为东八区时间
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
# 配置时区为东八区。 Java可以通过Timezone获取时区的，修改完重启服务即可。
echo 'Asia/Shanghai' >/etc/timezone
+

如果是docker的话，将宿主机改为上述配置后，docker容器启动(run)增加挂载配置就可以了

+
1
2
-v /etc/localtime:/etc/localtime
-v /etc/timezone:/etc/timezone
+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + + + + + + +
+ + +
+ + + #java + + #异常 + + #oracle + + #docker + +
+ +
+ + + + + +
+
+
java应用连接docker内的oracle时报ORA-01882错误
+
https://www.hancher.top/2023/08/18/exception-java-oracle-docker-timezone-not-find/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年8月18日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/10/13/linux-linux-crontab-not-work/index.html b/2023/10/13/linux-linux-crontab-not-work/index.html new file mode 100644 index 00000000..c52d77da --- /dev/null +++ b/2023/10/13/linux-linux-crontab-not-work/index.html @@ -0,0 +1,793 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + linux定时任务crontab不执行的问题排查过程 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

linux定时任务crontab不执行的问题排查过程

+ + +
+ +

背景

最近在搞一个比较复杂的crontab 定时任务， 核心思路就是通过crontab触发一个bash脚本，调用docker内的一个指令，来实现docker积压日志的删除清理操作。

+

然后问题就来了：我通过命令行调用脚本，能够正常执行，但是通过crontab，脚本就死活调用不成功。

+

以下就是记录的排查crontab调用不成功的过程：

+

案发现场

crontab上配置定时任务,把该有的环境变量都配置上，脚本的开头也加上了source /etc/profile 为了方便排查，调度改为2分钟一次

+
1
*/2 * * * *  /usr/bin/docker exec -it container-name bash  -c 'sh /var/log/del_overdue_log.sh'
+

不出意外的话，定时任务调度失败了。

+

通过tail -f /var/log/cron 去cron调度日志里查看调用情况：

+
1
2
Oct 13 10:58:01 : CROND[27764]: (root) CMD (/usr/bin/docker exec -it container-name bash  -c 'sh /var/log/del_overdue_log.sh')
Oct 13 10:58:01 : (root) MAIL (mailed 54 bytes of output but got status 0x004b#012)
+

日志表示，我们的cron任务调度了，但是没有成功。 失败原因本来想通过mail发给当前root用户的，但发送失败了，原因是获得了一个失败状态吗。

+

如何解决这个mail发送失败的问题呢?

+

启用postfix 接收系统邮件

去/etc/postfix/main.cf 配置文件,搜索inet_interfaces，改成如下配置

+
1
2
inet_interfaces = all
# inet_interfaces = localhost
+

重启postfix

+
1
systemctl restart postfix
+

此时，我们就可以收到cron调度失败的系统通知邮件了。

+

tail -f /var/spool/mail/root 查看邮件信息：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
From root@host.localdomain  Fri Oct 13 12:56:01 2023
Return-Path: <root@host.localdomain>
X-Original-To: root
Delivered-To: root@host.localdomain
Received: by host.localdomain (Postfix, from userid 0)
	id D94301329A7; Fri, 13 Oct 2023 12:56:01 +0800 (CST)
From: "(Cron Daemon)" <root@host.localdomain>
To: root@host.localdomain
Subject: Cron <root@host> /usr/bin/docker exec -it container-name bash  -c 'sh /var/log/del_overdue_log.sh'
Content-Type: text/plain; charset=UTF-8
Auto-Submitted: auto-generated
Precedence: bulk
X-Cron-Env: <XDG_SESSION_ID=2387>
X-Cron-Env: <XDG_RUNTIME_DIR=/run/user/0>
X-Cron-Env: <LANG=en_US.UTF-8>
X-Cron-Env: <SHELL=/bin/sh>
X-Cron-Env: <HOME=/root>
X-Cron-Env: <PATH=/usr/bin:/bin>
X-Cron-Env: <LOGNAME=root>
X-Cron-Env: <USER=root>
Message-Id: <20231013045601.D94301329A7@host.localdomain>
Date: Fri, 13 Oct 2023 12:56:01 +0800 (CST)

the input device is not a TTY
+

会发现，失败的原因是我们的脚本调度器不是TTY(终端)，所以失败了。

+
+

注意，问题定位后记得把postfix配置恢复原状

+
+

问题定位

找到日志了，任务调度失败的原因也找到了，分析一下我们的任务指令，发现我们在脚本调度命令里存在选项 docker exec -it 配置。

+

问题就在这个-it 上面了，这要求我们开启一个交互式终端来控制docker指令，而crontab调度器明显不是一个终端，所以失败了。

+

问题解决

把命令行里的-it去掉，改为-d后端调用就可以了。以下是最终版配置

+
1
* 1 * * *  /usr/bin/docker exec -d container-name bash  -c 'sh /var/log/del_overdue_log.sh' >/dev/null 2>$1
+

最终指令改了两点:

+
    +
  1. 将-it改为-d， 解决crontab调度失败的问题。
    2. +
  2. 在crontab命令上增加 >/dev/null 2>$1 配置，这是为了取消任务调度的系统日志产生，防止系统日志爆炸，也可以不加。
    3. +
+

结论

授之以渔不如授之以渔， 出现问题不可怕，只要我们掌握了一些解决问题的方法论， 任何问题都能迎刃而解。

+

参考

‘crontab’ in Linux with Examples

+

crontab不执行排查

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 编程人生 + + + + + + + + +
+ + +
+ + + #linux + +
+ +
+ + + + + +
+
+
linux定时任务crontab不执行的问题排查过程
+
https://www.hancher.top/2023/10/13/linux-linux-crontab-not-work/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年10月13日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2023/11/29/spring-springdoc-openapi/index.html b/2023/11/29/spring-springdoc-openapi/index.html new file mode 100644 index 00000000..319bb9f0 --- /dev/null +++ b/2023/11/29/spring-springdoc-openapi/index.html @@ -0,0 +1,797 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + springdoc-openapi的集成与常见问题 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

springdoc-openapi的集成与常见问题

+ + +
+ +

在项目中经常使用swagger来作为项目接口的自动化api文档，尤其是springboot项目，一般都是通过springfox-boot-starter来集成swagger的使用。
springfox-boot-starter 在2.x时代用着很方便，但是随着项目的发展，尤其是spring项目的不断推出新版本，
springfox-boot-starter在3.0版本就已经明显存在兼容性问题了，而且已经3年多没维护了，所以寻找替代品是一种虽然不紧迫但很必须的事项了。
而springdoc-openapi就是springfox-boot-starter的替代品，且获得了swagger的官方支持，算是springfox在springboot高版本的天热替代品。
springfox已经3年未更新了

+

本文就介绍springdoc-openapi的集成与常见问题。

+

项目依赖

如果你的项目是springboot2.x版本，请使用springdoc-openapi的1.x版本。
如果你的项目是springboot3.x版本，请使用springdoc-openapi的2.x版本。

+

本文案例的环境是：

+
    +
  • java 17
    • +
  • springboot 2.7.18
    • +
+

开始

使用idea创建一个新的maven springboot项目，添加如下依赖

+
1
2
3
4
5
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-ui</artifactId>
    <version>1.7.0</version>
</dependency>
+ +

创建一个Controller

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@RestController
@RequestMapping("/hello")
@Tag(name="openapi demo")
public class HelloWorldController {

    @GetMapping("/world")
    @Operation(summary = "helloWorld接口",description = "接口描述信息")
    @Parameter(name = "name", description = "名称", required = true,  in = ParameterIn.QUERY)
    public String helloWorld(String name) {
        return "Hello "+ Optional.of(name).orElse("world");
    }

    /**
     * 隐藏的api，不再swagger 显示
     */
    @GetMapping("/hidden")
    public String hiddenApi(String name) {
        return "Hello "+ Optional.of(name).orElse("world");
    }
}
+

然后就可以直接启动了，不用任何配置，就可以看到swagger的界面了。
swagger默认地址： http://localhost:8080/swagger-ui/index.html#/
springdoc版的swagger的默认页面

+

通过配置文件修改相关配置

如果你不想使用默认的配置，可以通过配置文件修改相关配置。比如我通过下面配置对swagger的界面进行了微调。

+
1
2
3
4
5
6
7
8
9
# application.properties
springdoc.swagger-ui.disable-swagger-default-url=true
# 布局 StandaloneLayout，BaseLayout
springdoc.swagger-ui.layout=BaseLayout
springdoc.swagger-ui.path=/v3/swagger-ui.html
# swagger-ui 默认关联的api接口配置, 要与api-docs.path 一致。 不配置默认取api-docs.path配置
springdoc.swagger-ui.url=/v3/test/api-docs
# api json 接口配置, 可以自定义其他json接口
springdoc.api-docs.path=/v3/test/api-docs
+

因为修改了swagger页面的访问地址，所以我们的访问地址变成了：
http://localhost:8080/v3/swagger-ui/index.html#/
效果如图：
springdoc版的swagger的properties配置版

+

通过自定义配置类修改相关配置

如果我们想要更自有的配置，可以通过自定义配置类来修改相关配置。

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
@Configuration
public class SwaggerConfig {
    /**
     * 添加摘要信息
     */
    @Bean
    public OpenAPI openAPI() {
        return new OpenAPI()
                .info(new Info().title("hancher demo open api")
                        .description("helloWorld接口文档")
                        .version("v3.0.0")
                        // 联系人
                        .contact(new Contact().name("寒澈").url("https://www.hancher.top/"))
                )
                // 其他文档信息
                .externalDocs(new ExternalDocumentation()
                        .description("寒澈笔记")
                        .url("https://www.hancher.top/"));
    }


    /**
     * 模式三： 自定义api分组
     *
     */
//    @Bean
    public GroupedOpenApi publicApi() {
        return GroupedOpenApi.builder()
                .packagesToScan("com.hancher.demo.springbootopenapi.controller") // 扫描包
                .displayName("寒澈openapi")
                .addOpenApiMethodFilter(method -> method.isAnnotationPresent(Operation.class))
                .build();
    }
}
+

还是默认访问地址：http://localhost:8080/swagger-ui/index.html#/
springdoc版的swagger的openapi配置版

+

迁移成本

除了将老版本的注解替换成新的注解之外，没有任何其他改的。
springfox迁移到springdoc的注解变动

+

集成中遇到的问题

我在集成过程中遇到的最大的问题就是明明集成好了，但是swagger的访问页面还是swagger的默认petStore的页面，而不是我配置的controller的页面。这个问题让我排查了好久。
springdoc总是显示默认petstore接口

+

首先，我们我们要先了解的是，swagger-ui是一套api展示页面，他的数据是从v3/api-docs接口获取的json数据。
所以排查问题，我们首先要看页面有没有调用这个接口（有可能我们在配置文件了将这个接口改了），再次看看这个接口有没有返回正常的json结果。
springdoc的数据接口
如果这这个接口返回了正常的数据，且是我们的配置的接口数据，那么问题很可能是我们的一些安全配置将swagger的相关接口给屏蔽了。
比如WebSecurityConfigurerAdapter, 我就是在这个环节上出的问题

+
1
2
3
4
5
6
7
8
9
@EnableGlobalMethodSecurity(prePostEnabled = true, securedEnabled = true)
public class SecurityConfig extends WebSecurityConfigurerAdapter
{
    @Override
    protected void configure(HttpSecurity httpSecurity) throws Exception
    {
        
    }
}
+ +

项目demo

集成了application，java bean config 两种方式的demo
springdoc-demo

+ + +
+ +
+
+
+ +
+ + + + + + + + + + spring + + + + + + + + +
+ + +
+ + + #spring + + #openapi + +
+ +
+ + + + + +
+
+
springdoc-openapi的集成与常见问题
+
https://www.hancher.top/2023/11/29/spring-springdoc-openapi/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2023年11月29日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2024/05/22/site-how-baidu-spide-github-site/index.html b/2024/05/22/site-how-baidu-spide-github-site/index.html new file mode 100644 index 00000000..bb9e6fe8 --- /dev/null +++ b/2024/05/22/site-how-baidu-spide-github-site/index.html @@ -0,0 +1,800 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如果让百度爬虫爬我的github博客 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

如果让百度爬虫爬我的github博客

+ + +
+ +

我们辛辛苦苦的通过github pages建好我们的博客之后。接下来可能会想要更多的人来访问我们的博客，
然后一顿操作后发现，github 把百度的爬虫屏蔽了，所以我们的网站也就不能被百度搜索了，我们的博客也就没法被百度搜索到了。

+

这怎么行呢？ 我们的博客主要群体还是国内的程序员的，少了百度这个来源，访问量一下子少了一大半。

+

作为一名程序员，我们怎么能被这个事情难倒呢？

+

让我们来分析一下，github 把百度的爬虫屏蔽了，这导致了我们的博客不能被百度收录。既然百度不能爬github了，我们可以让百度去别的地方爬我们的博客呀。

+

思路一开天地宽，我们可以通过CDN的机制来把我们的博客搬到CDN上，然后让百度访问CDN就可以了呀。

+

可惜，试过七牛云等一些国内的CDN，发现同步网站还要备案，这个我要是有，也就不用这么麻烦的想办法同步内容到百度了，这一步是走不通了。

+

最后，我发现了vercel这个网站，可以镜像我们的github 博客，而又没有屏蔽百度的爬虫，完美的解决了我的问题。

+

准备

    +
  • github博客站建好
    • +
  • 一个域名，我们需要域名来做博客的跳转。
    • +
+

操作

关联vercel

    +
  1. 注册登录vercel
    2. +
  2. 新建一个项目（add new project）, 关联到自己github上的 博客仓库
    vercel关联github
    3. +
  3. 添加指向vercel项目的二级域名，比如我的blog.hancher.top
    vercel配置域名
    4. +
  4. 此时，我们在Vercel里的项目已经构建好了，下次 GitHub 项目的任何更新都会触发 Vercel 项目更新
    vercel效果
    5. +
+

配置域名解析

去域名的解析后台，添加域名的CNAME解析，记录值cname-china.vercel-dns.com 此时，通过blog.hancher.top就可以访问vercel CDN上的静态网站了。

+

当然，也可以将记录值改为Vercel的自己项目的vercel.app 域名。将线路解析类型改为百度 亦可。

+

关联百度解析

    +
  1. 去百度站点管理 里注册账号，创建blog.hancher.top域名的网站，即可以抓取我们的博客站点了。
    2. +
  2. 将百度给的一个签名放到网站的根目录下
    百度站点
    3. +
  3. 通过抓取诊断 来验证我们的博客是否可以正常抓取
    抓取诊断
    4. +
  4. 耐心等待几天，在百度搜索框里搜索 site:blog.hancher.top来验证我们的配置是否生效，此时大概率就能搜到自己的博客文章了。
    验证博客
    5. +
+

2024年更新

因为Vercel被墙（dns污染方式）, 该方法暂时失效。等待后续解决。

+

参考

知乎-如何解决百度爬虫无法爬取搭建在Github上的个人博客的问题
建站过程中的踩坑记录：自定义域名、百度收录与备案

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + + #vercel + + #网站曝光 + +
+ +
+ + + + + +
+
+
如果让百度爬虫爬我的github博客
+
https://www.hancher.top/2024/05/22/site-how-baidu-spide-github-site/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2024年5月22日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2024/08/01/db-mysql-waiting-for-global-read-lock/index.html b/2024/08/01/db-mysql-waiting-for-global-read-lock/index.html new file mode 100644 index 00000000..52fff390 --- /dev/null +++ b/2024/08/01/db-mysql-waiting-for-global-read-lock/index.html @@ -0,0 +1,789 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + mysql出现了waiting for global read lock 全局事务等待问题排查 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

mysql出现了waiting for global read lock 全局事务等待问题排查

+ + +
+ +

问题发现

在一个普通的日子里，寒澈在操作他负责的一个内部系统的时候，突然发现一个修改状态的操作不能操作了。 查看服务器日志，发现数据库连接超时了：
mysql连接超时
第一反应是数据库挂了，导致数据库连不上了。

+

可是，神奇的是，接下来发现数据库的查询功能还能用，但是所有的状态修改类的写操作都不能用了。 这下知道遇到麻烦了，肯定是mysql数据库的产生锁了，把所有的写操作阻塞了。

+

按照现在的这个情况，mysql读没有问题，写被阻塞，出问题的锁肯定是读锁（共享锁），而且还是全局性质的，因为所有的写都被影响了。

+

问题定位

按照上面的思路去数据库里执行一下SHOW ENGINE INNODB STATUS, 查看一下数据库的状态。 结果如下：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
*** WE ROLL BACK TRANSACTION (2)
------------
TRANSACTIONS
------------
Trx id counter 48415098
Purge done for trx's n:o < 48412278 undo n:o < 0 state: running but idle
History list length 0
LIST OF TRANSACTIONS FOR EACH SESSION:
---TRANSACTION 421386947297640, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947296832, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947296024, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947295216, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947294408, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947293600, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947291984, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947288752, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947287944, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947287136, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947283904, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947280672, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
+

发现了大量的如上的事务在积压，没有执行。 与预期一致，就是某个锁导致事务阻塞了。

+

注意这里不会是死锁问题，因为死锁是锁冲突，mysql会自动解决的，不会导致事务长时间阻塞。

+

查询一下mysql的执行进程，看看情况：

+
1
2
# 查询一个耗时最久的 进程
select * from information_schema.PROCESSLIST order by time desc;
+

发现了如下场景
waiting for global read lock

+

由此我们知道：

+
    +
  1. 确实发生了一个全局性的读锁waiting for global read lock导致了后续写操作的进行。 后面的事务都在等待这个读锁的释放。
    2. +
  2. 情况比我们想象的严重，这个读锁不仅影响了我们自己的实例，还把整个mysql下所有的库实例都影响了。
    3. +
  3. 问题的原因也发现了，就是有一个binlog dump后没有结束导致的。也就是那个耗时最久的进程。
    4. +
+

问题解决

既然发现了这个锁产生的原因，直接把这个进程kill掉就可以了

+
1
kill 3518815
+

binlog的进程杀掉后，后面阻塞的任务果然都没了。

+

记录一下排查问题过程中常用的sql

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查询当前元数据锁及关联的线程和事务
select * from performance_schema.metadata_locks l
left join performance_schema.threads t on t.THREAD_ID = l.OWNER_THREAD_ID 
left join performance_schema.events_transactions_current  et on et.THREAD_ID  = t.THREAD_ID 
left join information_schema.INNODB_TRX  trx on t.PROCESSLIST_ID = trx.trx_mysql_thread_id  

# 当前系统内的事务
select * from information_schema.innodb_trx;

# 查询一个耗时最久的 进程
select * from information_schema.PROCESSLIST order by time desc;

# 查询innodb 状态
SHOW ENGINE INNODB STATUS
+ +

问题避免

发现问题，解决问题，避免问题才是我们排查问题最终要的目的。

+

我们这个问题是flink cdc 数据的时候导致的，后续的解决办法很简单：
第一： 以后flink 不要cdc主库了，避免对业务产生影响。
第二：flink cdc 一定要做好异常拦截处理，我们这就是因为异常导致fink退出了，无法释放锁
第三：如果可以的话，尽量使用flink的无锁cdc版本

+

关于这个global read lock是怎么产生的

当mysql在dump整个数据库的时候，会对数据库执行一个FLUSH TABLES WITH READ LOCK命令来加锁，这个命令会停止对所有表的写操作，‌并允许读操作继续。
等备份完成，会使用UNLOCK TABLES来解锁，

+

参考

mysql 加 global read lock 机制

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 数据库 + + + + + + + + +
+ + +
+ + + #mysql + +
+ +
+ + + + + +
+
+
mysql出现了waiting for global read lock 全局事务等待问题排查
+
https://www.hancher.top/2024/08/01/db-mysql-waiting-for-global-read-lock/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2024年8月1日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2024/12/25/safe-clamav-and-scan/index.html b/2024/12/25/safe-clamav-and-scan/index.html new file mode 100644 index 00000000..e340bef5 --- /dev/null +++ b/2024/12/25/safe-clamav-and-scan/index.html @@ -0,0 +1,864 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + linux安装ClamAV杀毒软件然后扫毒 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

linux安装ClamAV杀毒软件然后扫毒

+ + +
+ +

背景

最近在一个项目上要求在linux服务器上安装杀毒软件，然后开启系统扫描，然后删除病毒。

+

然后找了找了一些资料，比较常用的有ClamAV 和 Comodo, 因为ClamAV开源，且使用比较广泛，最终选择了ClamAV。

+

我们的服务器是centos7.9, 下面就是在CentOS上安装ClamAV的过程，比较简单。

+

CentOS 上安装ClamAV

以下是在 CentOS 上安装 ClamAV 步骤：

+

步骤 1：安装 EPEL 仓库

ClamAV 通常通过 EPEL（Extra Packages for Enterprise Linux）仓库提供，因此首先需要确保 EPEL 仓库已安装。

+

如果失败可以考虑使用阿里云的源 yum 仓库更换阿里云

+
1
sudo yum install epel-release -y
+ +

步骤 2：安装 ClamAV

安装 EPEL 仓库后，你可以通过以下命令安装 ClamAV：

+
1
sudo yum install clamav clamav-update clamd -y
+ +
    +
  • clamav 包含命令行工具（如 clamscan）。
    • +
  • clamav-update 是更新病毒库所需的工具（即 freshclam）。
    • +
  • clamd 是clam的系统服务。
    • +
+

验证安装是否成功：

+
1
clamscan --version
+ +

步骤 3：更新病毒库

安装完成后，首先需要更新 ClamAV 的病毒库，以确保它能识别最新的恶意软件。运行以下命令：

+
1
sudo freshclam
+ +

freshclam 会从 ClamAV 的服务器下载并更新病毒库，如果超时，等一会再多试几次，我试了3次成功了。

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
ClamAV update process started at Wed Dec 25 16:33:20 2024
WARNING: Your ClamAV installation is OUTDATED!
WARNING: Local version: 0.103.11 Recommended version: 0.103.12
DON'T PANIC! Read https://docs.clamav.net/manual/Installing.html
daily database available for download (remote version: 27497)
Time:   14.0s, ETA:    0.0s [========================>]   61.48MiB/61.48MiB
Testing database: '/var/lib/clamav/tmp.8095e9d84b/clamav-0e8a55acea5c8848d6871677901e577d.tmp-daily.cvd' ...
Database test passed.
daily.cvd updated (version: 27497, sigs: 2071426, f-level: 90, builder: raynman)
main database available for download (remote version: 62)
Time:   50.6s, ETA:    0.0s [========================>]  162.58MiB/162.58MiBBB
Testing database: '/var/lib/clamav/tmp.8095e9d84b/clamav-ac7f382ef620ff4ad4d10aaed27f9dce.tmp-main.cvd' ...
Database test passed.
main.cvd updated (version: 62, sigs: 6647427, f-level: 90, builder: sigmgr)
bytecode database available for download (remote version: 335)
Time:    1.5s, ETA:    0.0s [========================>]  282.94KiB/282.94KiB
Testing database: '/var/lib/clamav/tmp.8095e9d84b/clamav-bbc727f2e5a1bc6a0e835c65fb9cf566.tmp-bytecode.cvd' ...
Database test passed.
bytecode.cvd updated (version: 335, sigs: 86, f-level: 90, builder: raynman)
+ +

步骤 4：启动 ClamAV 守护进程（可选）

如果你希望使用 ClamAV 的守护进程（clamd），你需要启动它。守护进程会提高扫描效率，特别是对于较大的文件。

+
    +
  1. 启用clam默认配置
    2. +
+
1
2
3
cp /etc/clamd.d/scan.conf /etc/clamd.d/scan.conf.bak
sed -i -e "s/^Example/#Example/" /etc/clamd.d/scan.conf
vim /etc/clamd.d/scan.conf
+

放开如下的注释

+
1
# LocalSocket /run/clamd.scan/clamd.sock
+ +
    +
  1. 重命名clam服务的@文件
    2. +
+
1
mv /usr/lib/systemd/system/clamd\@.service /usr/lib/systemd/system/clamd.service
+
    +
  1. 修改服务配置
    2. +
+
1
2
3
4
5
6
7
8
9
10
11
12
[Unit]
Description = clamd scanner daemon
After = syslog.target nss-lookup.target network.target
[Service]
Type = forking
ExecStart = /usr/sbin/clamd -c /etc/clamd.d/scan.conf
# Reload the database
ExecReload=/bin/kill -USR2 $MAINPID
Restart = on-failure
TimeoutStartSec=420
[Install]
WantedBy = multi-user.target
+ + +
    +

  1. 启动 clamd 服务：

    +
    1
    2
    sudo systemctl daemon-reload
    sudo systemctl start clamd.service
    +
    2. +

  2. 设置 clamd 在系统启动时自动启动：

    +
    1
    sudo systemctl enable clamd.service
    3. +
+

步骤 5：运行 ClamAV 执行病毒扫描

你可以使用 clamscan 执行病毒扫描。以下是一些常见的用法：

+
    +

  • 扫描单个文件：

    +
    1
    clamscan /path/to/file
    +
    • +

  • 扫描整个目录：

    +
    1
    clamscan -r /path/to/directory
    +
    • +

  • 扫描并删除感染文件：

    +
    1
    clamscan -r --remove /path/to/directory
    +
    • +

  • 扫描并显示详细信息：

    +
    1
    clamscan -r -v /path/to/directory
    +
    • +

  • 将结果输出到文件：

    +
    1
    2
    3
    4
    5
    clamscan -r /path/to/directory --log=clamav_scan_results.txt
    # or
    clamscan -r /path/to/directory > clamav_scan_results.txt
    # 后台运行
    nohup clamscan -r /path/to/directory --log=clamav_scan_results.txt &
    +

    结果：

    +
    • +
+
1
2
3
4
5
6
7
8
9
10
11
12
----------- SCAN SUMMARY -----------
Known viruses: 8702931
Engine version: 0.103.11
Scanned directories: 44573
Scanned files: 66053
Infected files: 0
Total errors: 21600
Data scanned: 4565.67 MB
Data read: 27114.51 MB (ratio 0.17:1)
Time: 1178.142 sec (19 m 38 s)
Start Date: 2024:12:25 17:12:38
End Date:   2024:12:25 17:32:17
+ +

步骤 6：配置 ClamAV (可选)

如果需要，你可以配置 ClamAV 来调整其行为。ClamAV 的配置文件位于：

+
    +
  • clamd 配置文件：/etc/clamd.d/scan.conf
    • +
  • freshclam 配置文件：/etc/freshclam.conf
    • +
+

你可以编辑这些配置文件，调整日志文件路径、扫描选项等。例如，编辑 clamd 配置文件来启用详细日志：

+
1
sudo vi /etc/clamd.d/scan.conf
+ +

修改以下内容：

+
1
2
LogFile /var/log/clamd.log
LogTime yes
+ +

步骤 7：定期更新病毒库

为了确保 ClamAV 能及时识别最新的威胁，你需要定期更新病毒库。你可以通过设置 cron 任务 来自动更新病毒库。

+
    +

  1. 编辑 crontab 文件：

    +
    1
    sudo crontab -e
    +
    2. +

  2. 添加以下行来每天更新病毒库（此例为每天凌晨 2 点）：

    +
    1
    0 2 * * * /usr/bin/freshclam --quiet
    3. +
+

总结

    +
  1. 安装 EPEL 仓库并通过 yum 安装 ClamAV。
    2. +
  2. 使用 freshclam 更新病毒库。
    3. +
  3. 启动并配置 clamd 守护进程（可选）。
    4. +
  4. 使用 clamscan 执行病毒扫描。
    5. +
  5. 配置定时任务自动更新病毒库。
    6. +
+

通过这些步骤，你可以在 CentOS 上成功安装和配置 ClamAV，帮助你扫描和清理系统中的病毒和恶意软件。

+

参考

clamav 官方文档

+

yum 仓库更换阿里云

+

centos7 配置ClamAV

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 安全 + + + + + + + + +
+ + +
+ + + #linux + + #安全 + +
+ +
+ + + + + +
+
+
linux安装ClamAV杀毒软件然后扫毒
+
https://www.hancher.top/2024/12/25/safe-clamav-and-scan/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2024年12月25日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2024/12/30/life-ntfs-for-mac-free/index.html b/2024/12/30/life-ntfs-for-mac-free/index.html new file mode 100644 index 00000000..fc2a2902 --- /dev/null +++ b/2024/12/30/life-ntfs-for-mac-free/index.html @@ -0,0 +1,788 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 西部数据提供免费版Paragon实现与mac电脑的读写 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

西部数据提供免费版Paragon实现与mac电脑的读写

+ + +
+ +

现象

俗套的现象：买了一个西部数据的移动硬盘，然后又买了一个mac电脑，将硬盘插入到电脑后发现硬盘里的数据可以读，但是无法将电脑里的文件写入。

+

其实本质上的原因就是 wb的硬盘是ntfs格式的, mac电脑不支持ntfs格式的读写.

+

本人电脑：macbook pro m1版

+

系统版本：macos 14

+

解决

如果为了保持和windows系统的兼容性，wb的硬盘必须使用ntfs格式，那么通过安装ntfs转换软件也能实现。mac应用商店里有很多这种软件，但是要收费。

+

应用商店之外常用的软件就是 uxera和Paragon，也要收费。

+

后来找了好久，在西部数据的官方帖子上找到一个免费实现的法子，原来西部数据官方也提供了一套mac版读写数据的驱动。

+

以下是官方帖子的链接：
Steps to Install Paragon NTFS Driver for macOS for WD and SanDisk Professional

+

大概安装步骤如下：

    +

  1. 下载驱动
    Paragon_NTFS_Driver_for_Mac
    解压后双击软件开始安装。

    +
    2. +

  2. 选择:安装ntfs for mac
    s1
    然后接着按照步骤一直下一步就可以了
    s2
    s3
    s4
    s5
    s6

    +
    3. +

  3. 在最后一步，会要求在系统配置里代开可信任权限，关机重启。
    需要注意的是，这里不仅仅是要求在mac的系统安全设置里打开第三方软件信任项，还要在系统的安全模型里开启对第三方软件的信任项。

    +
    4. +
+

如果以前没有修改过安全模型下的配置，大概率会提示需要在“恢复”环境中修改安全性设置。

+

这个需要在电脑关机后，长按触控ID或电源按钮就能进入安全配置环境，选择设置配置，然后在上面的菜单选择里找到安全配置相关菜单，勾选信任第三方软件修改系统内核就可以了（因为是安全模式，没有截图，按照这个步骤找就可以了）。

+

如果对电脑安全有洁癖的用户，这一步操作要慎重，也可以转投付费阵营。

+

补充

因为网络的原因，上面的驱动可能是下载失败，这里提供一个备用地址：
Paragon_NTFS_Driver_for_Mac.zip 17.0.246 (访问密码: 45td)

+

驱动版本列表

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 生活 + + + + + + + + +
+ + +
+ + + #生活 + +
+ +
+ + + + + +
+
+
西部数据提供免费版Paragon实现与mac电脑的读写
+
https://www.hancher.top/2024/12/30/life-ntfs-for-mac-free/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2024年12月30日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2025/01/03/site-plan-in-2025/index.html b/2025/01/03/site-plan-in-2025/index.html new file mode 100644 index 00000000..94fced7c --- /dev/null +++ b/2025/01/03/site-plan-in-2025/index.html @@ -0,0 +1,781 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 2025年博客更新计划 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

2025年博客更新计划

+ + +
+ +

2025年博客更新计划

2024年已经过去，2025年已经到来。

+

在过去的一年了，因为经历了很多重大的事情，比如换工作、比如结婚、再比如公众号等原因，导致这个博客更新的频率比较慢。

+

现在，2025年了，新的开始，我也打算重新恢复博客的更新计划，并制定一些规划，既是我这一年努力的方向，也方便在2025年末的时候回来复盘。

+

更新计划

网站部分

    +
  • 现在的主题感觉有点丑，而且在文档归档方面有点不足，看到一个新的主题很喜欢，计划改造一下，可能会伤筋动骨
    • +
  • 彻底解决国内访问本网站的问题，目前发现的参考文章,有空研究一下
    • +
  • 研究一下，如何让博客拥有更新时间的功能,记录我对博客内容的修改
    • +
  • 为了加快网站的访问速度，考虑引入图床功能
    • +
  • 将上述改造整理成文档，并分享到博客
    • +
+

内容部分

    +
  • 博客的定位从纯技术博客，变更为一个技术+生活类型模块，增加一些非技术类的内容
    • +
  • 我的部分改造升级，打通我的所有的内容生态体系，提升我的个人品牌
    • +
  • 计划开发一套个人的小程序，并记录小程序上线的全过程
    • +
  • 增加一些收集的资源分享功能，开源分享的精神总要有人来继承
    • +
  • 技术方面，除了日常问题的总结外，继续向上游理论部分探索
    • +
+

生命不息，折腾不止

发现我就是一个喜欢折腾的人

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + + #更新计划 + +
+ +
+ + + + + +
+
+
2025年博客更新计划
+
https://www.hancher.top/2025/01/03/site-plan-in-2025/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2025年1月3日
+
+ + + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2025/01/07/site-hexo-from-jekyll/index.html b/2025/01/07/site-hexo-from-jekyll/index.html new file mode 100644 index 00000000..aaf7f7a2 --- /dev/null +++ b/2025/01/07/site-hexo-from-jekyll/index.html @@ -0,0 +1,841 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + jekyll迁移到Hexo博客架构全过程 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

jekyll迁移到Hexo博客架构全过程

+ + +
+ +

为什么要迁移到hexo

什么是Hexo

Hexo 是一个快速、简洁且高效的博客框架（使用NodeJs）。 Hexo 使用 Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

+

为什么选择了Hexo

    +
  1. 好看，好看，好看
    2. +
  2. 其中的归档功能做的很好，支持分组、也支持标签
    3. +
  3. 很好的集成了网站统计相关的功能
    4. +
+

迁移过程

Hexo环境搭建

    +
  1. 首先确保安装了nodejs和git
    因为 Hexo 是基于 nodejs 的，所以需要先安装 nodejs，这里我使用的是 nvm 管理 nodejs 版本，安装好 nvm 后，执行 nvm install nodejs 安装 nodejs。
    2. +
+

我安装的是2025年1月最新lts版本的nodejs: v22.12.0

+
    +
  1. 安装Hexo
    2. +
+
1
npm install -g hexo-cli
+

因为我的nodejs是最新版本，所以我的hexo版本是也是当前最新版本： 7.3.0

+

创建Hexo博客网站

选择一个你想创建项目代码的位置，执行以下命令创建Hexo博客网站：

+
1
2
3
4
5
6
7
# 选择合适的nodejs 版本
nvm use v22.12.0
# 创建项目
hexo init my_blod
cd my_blod
# 初始化依赖
npm install
+

然后我们就得到了一个默认的博客项目my_blog，其中的package.json文件如下：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": "7.3.0"
  },
  "dependencies": {
    "hexo": "^7.3.0",
    "hexo-generator-archive": "^2.0.0",
    "hexo-generator-category": "^2.0.0",
    "hexo-generator-index": "^4.0.0",
    "hexo-generator-tag": "^2.0.0",
    "hexo-renderer-ejs": "^2.0.0",
    "hexo-renderer-marked": "^7.0.0",
    "hexo-renderer-stylus": "^3.0.1",
    "hexo-server": "^3.0.0",
    "hexo-theme-fluid": "^1.9.8",
    "hexo-theme-landscape": "^1.0.0"
  }
}
+

到了这一步，我们就可以启动最原始版本的项目了：

+
1
2
3
4
cd my_blod
hexo server
# or 
npm run server
+

然后访问 http://localhost:4000 就可以看到默认的博客了。
hexo默认主题页面
官方给我们创建了一个hello world的博客. 我们可以参考这个来写我们自己的博客了。

+

常用的hexo命令参考这里

+

安装我喜欢的主题Fluid

当然这里可以使用任何你喜欢的主题，安装模式大同小异。

+
    +
  1. 安装Fluid主题的最新版本
    2. +
+
1
2
cd my_blod
npm install --save hexo-theme-fluid
+
    +
  1. 配置主题
    如下修改 Hexo 博客目录中的 _config.yml：
    2. +
+
1
2
3
theme: fluid  # 指定主题

language: zh-CN  # 指定语言，会影响主题显示的语言，按需修改
+
    +
  1. 创建【关于页】
    首次使用主题的「关于页」需要手动创建：
    2. +
+
1
hexo new page about
+

创建成功后修改 /source/about/index.md，添加 layout 属性，。

+
1
2
3
4
5
6
---
title: 标题
layout: about
---

这里写关于页的正文，支持 Markdown, HTML
+
+

layout: about 必须存在，并且不能修改成其他值，否则不会显示头像等样式。

+
+

fluid主题启动后的博客页面

+

迁移jekyll博客文章

文章迁移

    +
  1. 把 _posts 文件夹内的所有文件复制到 source/_posts 文件夹
    2. +
  2. 在 _config.yml 中修改 new_post_name 参数
    3. +
+
1
new_post_name: :year-:month-:day-:title.md
+
    +
  1. 如果不想使用步骤2，也可以把所有的文章的文件名的年月日前缀去掉，也可以（作为轻度洁癖患者，我选的这种方式）。
    2. +
+

图片迁移

原先我的所有的图片资源都是在项目的根目录下的 /images 路径下，然后在文章里通过markdown的图片引用方式引用。

+

迁移到hexo后，只需将images目录 移动到 source 路径下，其他的都不用动，图片就可以自动解析了。

+

因为hexo 会将source目录下的所有文件都移动到网站的根路径下，所以图片的最终引用地址是一样的。

+

网站配置修改

通用hexo配置按照如下配置修改 _config.yml 文件：

+
1
2
3
4
5
# 网站名称
title: 寒澈笔记
subtitle: '一个程序员眼中的世界'
# 网站路径
url: https://www.hancher.top
+

fluid主题配置特性配置修改如下文件_config.fluid.yml， 会根据主题配置自动选择相应主题的配置。
而且这里的配置优先级最高，会覆盖_config.yml配置。

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# fluid 主题配置

# 网站配置
## 头部
navbar:
  # 博客标题
  blog_title: 寒澈笔记
  # 可以自定义导航栏
#  menu:
#    - { key: 'home', link: '/', icon: 'iconfont icon-home-fill' }
#    - { key: 'tag', link: '/tags/', icon: 'iconfont icon-tags-fill' }
#    - { key: 'about', link: '/about/', icon: 'iconfont icon-user-fill', name: '联系我' }

## 底部
footer:
  statistics:
    enable: true
    source: "busuanzi"  # 可选 leancloud | busuanzi  根据自己需求选择
    pv_format: "总访问量 {} 次"  # 显示的文本，{}是数字的占位符（必须包含)，下同
    uv_format: "总访客数 {} 人"

force_https: false  # 强制https

# 内容配置
## 首页
index:
  slogan:
    enable: true
    text: 人生总有一些东西值得回忆

about:
  name: "寒澈"
  intro: "一名喜欢文史哲的程序员"
  icons:  # 不要把 icon 注释掉，否则无法覆盖配置
   - { class: 'iconfont icon-github-fill', link: 'https://github.com/Hanchers/hanchers.github.io' }
   - { class: 'iconfont icon-zhihu-fill', link: 'https://www.zhihu.com/people/bh.zhi' }
   - { class: 'iconfont icon-wechat2-fill', qrcode: '/images/about/see-history.jpg' }

## 文章
post:
  meta:
    author:  # 作者，优先根据 front-matter 里 author 字段，其次是 hexo 配置中 author 值
      enable: false
    date:  # 文章日期，优先根据 front-matter 里 date 字段，其次是 md 文件日期
      enable: false
      format: "dddd, MMMM Do YYYY, h:mm a"  # 格式参照 ISO-8601 日期格式化
    wordcount:  # 字数统计
      enable: true
      format: "{} 字"  # 显示的文本，{}是数字的占位符（必须包含)，下同
    min2read:  # 阅读时间
      enable: true
      format: "{} 分钟"
    views:  # 阅读次数
      enable: true
      source: "busuanzi"  # 统计数据来源，可选：leancloud | busuanzi   注意不蒜子会间歇抽风
      format: "{} 次"
  copyright:  # 版权声明
    license: 'BY-NC-ND'
    update_date:   # 来源 front-matter 里 updated 字段
      enable: true

+ +

github pages 配置修改

我是用的私有项目，然后通过github action的方式来自动编译部署github pages的， 具体可以参考我的历史文章，有记录。

+

这里要做的是在github 上重新配置hexo环境和 打包脚本。

+

进入本地项目的 .github/workflows目录下，删除以前的workflow文件，然后新建一个文件，文件名随意，内容如下：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# ci name
# ci 脚本名称
name: Deploy Hexo site to public github repos

on:
  # Runs on pushes targeting the default branch
  # 当代码 push 到 main 分支时, 执行该脚本
  push:
    branches:
      - main

  # Allows you to run this workflow manually from the Actions tab
  # 允许你 手动执行 这个脚本
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
# GITHUB_TOKEN 的操作权限
permissions:
  contents: read
  pages: write
  id-token: write

# Allow one concurrent deployment
concurrency:
  group: "pages"
  cancel-in-progress: true

# job 执行任务, 可以有多个, 默认并行运行, 可以通过 needs 关键字来设置依赖的其他 jobs
# step : 任务下的执行步骤, 一个job 会有多个步骤
# 操作:  一个step 下可以执行多个操作, 通常一行脚本为一个操作
jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout版本
        uses: actions/checkout@v4
      # 准备ruby 环境
      - name: 使用Node： v22.12.0
        uses: actions/setup-node@v4
        with:
          # Examples: 20, 18.19, >=16.20.2, lts/Iron, lts/Hydrogen, *, latest, current, node
          # Ref: https://github.com/actions/setup-node#supported-version-syntax
          node-version: "22.12"
      - name: 缓存 NPM 依赖
        uses: actions/cache@v4
        with:
          path: node_modules
          key: ${{ runner.OS }}-npm-cache
          restore-keys: |
            ${{ runner.OS }}-npm-cache
      - name: 安装npm依赖
        run: npm install
      - name: 构建博客内容
        run: npm run build
      - name: 更新博客网站到public目录
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public

      - name: 部署_site到博客网站仓库
        working-directory: ./public
        run: |
          git init
          git checkout -b main
          git add -A
          git -c user.name='hancher' -c user.email='hanchers@outlook.com' commit -m 'update blog' 
          git push "https://${{github.actor}}:${{secrets.PUB_BLOG}}@github.com/Hanchers/hanchers.github.io" HEAD:main -f -q

+

如果不是私有项目部署的话，使用官方的配置即可。官方配置如下：

+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
name: Hexo 博客部署

on:
  push:
    branches:
      - main # default branch

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          # If your repository depends on submodule, please see: https://github.com/actions/checkout
          submodules: recursive
      - name: Use Node.js 20
        uses: actions/setup-node@v4
        with:
          # Examples: 20, 18.19, >=16.20.2, lts/Iron, lts/Hydrogen, *, latest, current, node
          # Ref: https://github.com/actions/setup-node#supported-version-syntax
          node-version: "20"
      - name: Cache NPM dependencies
        uses: actions/cache@v4
        with:
          path: node_modules
          key: ${{ runner.OS }}-npm-cache
          restore-keys: |
            ${{ runner.OS }}-npm-cache
      - name: Install Dependencies
        run: npm install
      - name: Build
        run: npm run build
      - name: Upload Pages artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public
  deploy:
    needs: build
    permissions:
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4
+ +

然后就可以到 hanchers.github.io 仓库下查看博客内容是否更新成功了。

+

如果博客内容更新了，就可以安装你的博客地址去访问博客了。

+

参考

  1. hexo 建站官方文档 + ↩
  2. fluid主题官方文档 + ↩
  3. jekyll博客迁移到hexo + ↩
+ +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + + #hexo + +
+ +
+ + + + + +
+
+
jekyll迁移到Hexo博客架构全过程
+
https://www.hancher.top/2025/01/07/site-hexo-from-jekyll/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2025年1月7日
+
+ + +
+
更新于
+
2025年1月9日
+
+ + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+ + +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/2025/01/09/site-hexo-comment-feature/index.html b/2025/01/09/site-hexo-comment-feature/index.html new file mode 100644 index 00000000..47cd97a0 --- /dev/null +++ b/2025/01/09/site-hexo-comment-feature/index.html @@ -0,0 +1,927 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + hexo建站增加自己的评论模块 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + +
+
+
+ + +
+ +
+
+
+
+

hexo建站增加自己的评论模块

+ + +
+ +

jekyll时代

使用的是beaudar插件, 在更新到hexo-fluid 博客架构后仍然可以使用，
但是需要代码侵入式改造，不如fluid适配的评论体系更优雅，所以这次我们尝试一些其他的评论插件。

+

评论插件的挑选原则：

+
    +
  • 免费：我的博客除了域名，全都是免费的，不可能为了一个评论模块而付费
    • +
  • 易接入：最后是fluid主题支持的，不然还要侵入式改造代码
    • +
  • 响应速度：希望评论模块快速响应
    • +
  • 可匿名：可以匿名发表评论，注册制会极大的影响用户发言的积极性
    • +
+

根据以上原则，我们对fluid官方支持的评论插件进行了筛选与评测：

+

beaudar

基于 GitHub Issues.博客的每次评论都会在github主站上生成一个issue，评论内容会以markdown格式保存在issue的评论区。
参考以前的文章：beaudar评论插件安装

+

Gitalk

基于 GitHub Issues. 通beaudar一样。

+

这种方式完全免费，且适合那些通过github pages 部署的博客。

+

安装过程

    +
  1. 点击这里申请github 的oauth授权应用
    github oauth 注册
    按图中配置即可，地址写自己博客的地址，其他的随便写，后续还可以改。
    2. +
  2. 创建app的密钥
    授权app的id和密钥
    3. +
  3. _config.yml里撇嘴gitalk的配置
    fluid配置：
    4. +
+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
post:
  comments:  # 开启评论
    enable: true
    type: gitalk # 选择评论插件类型

gitalk:
  clientID: xxxxxxxxx           # github 应用id，必须
  clientSecret: 6fcbc2edcfxxx   # github 应用密钥，必须
  repo: hanchers.github.io      # github 仓库， 必须
  owner: hancher                # github 仓库所有者， 必须
  admin: ['admin']              # github 仓库有写权限的账号
  language: zh-CN               # 语言
  labels: ['Gitalk']            # GitHub issue 的标签。
  perPage: 10                   # 每页大小
  pagerDirection: last          # 评论排序方式， last为按评论创建时间倒叙，first为按创建时间正序
  distractionFreeMode: false    # 类似Facebook评论框的全屏遮罩效果.
  createIssueManually: true     # 如果当前页面没有相应的 isssue 且登录的用户属于 admin，则会自动创建 issue。如果设置为 true，则显示一个初始化页面
  # 反向代理，为了支持 CORS. 默认的不可用，需要自己配置，参考下述文档
  # https://github.com/gitalk/gitalk/issues/429
  # https://github.com/Zibri/cloudflare-cors-anywhere
  proxy: https://shielded-brushlands-08810.herokuapp.com/https://github.com/login/oauth/access_token # 有些人搭建的代理
#  proxy: https://cors-server.68756978.xyz/github_access_token  # 备用代理地址1

+

效果如图，然后我们就可以评论了
gitalk评论效果图

+

评价

    +
  1. 需要配置代理地址，这里有一定的开发成本，如果使用开源的，不稳定性还很高（放弃选择的主要原因）。
    2. +
  2. 使用上需要注册github
    3. +
  3. 响应有点慢
    4. +
+

utterances

同样也是基于GitHub Issues实现，原理通上面的一样

+

安装过程

同beaudar一样，点击这里在github上安装应用。

+

选择你的github博客仓库。
utterances安装选择
安装好后，在_config.yml里配置utterances的配置即可

+
1
2
3
4
5
6
7
8
9
10
11
12
post:
  comments:  # 开启评论
    enable: true
    type: gitalk # 选择评论插件类型

# 其他配置可以参考官网
utterances:
  repo: Hanchers/Hanchers.github.io
  issue_term: pathname
  label: utterances
  theme: github-light
  theme_dark: github-dark
+

效果：
utterances效果

+

评价

    +
  1. utterances整体上比gitalk要好一些，安装简单很多，且不用代理。
    2. +
  2. 完全依赖github，这一点和beaudar一样，能满足我评价数据持久化的需求。
    3. +
  3. 不幸的是，响应上，同beaudar一样，都比较慢
    4. +
  4. fluid主题支持，安装很简单。
    5. +
  5. 评价功能使用比较少，且不喜欢折腾的，这款插件值得推荐。
    6. +
+

giscus

giscuss是利用 GitHub Discussions 实现的评论系统。

+

同上级几个评论插件不同的是，前面的是利用的GitHub Issues，而giscuss是利用GitHub Discussions。
github讨论模块
giscus 加载时，会使用 GitHub Discussions 搜索 API 根据选定的映射方式（如 URL、pathname、title 等）来查找与当前页面关联的 discussion。如果找不到匹配的 discussion，giscus bot 就会在第一次有人留下评论或回应时自动创建一个 discussion。

+

访客如果想要评论，必须按照 GitHub OAuth 流程授权 giscus app 代表他发布，或者可以直接在 GitHub Discussion 里评论。你可以在 GitHub 上管理评论。

+

安装过程

    +

  1. 启用github仓库的Discussions功能

    +
    2. +

  2. 点击这里安装giscus应用，然后选择你开启讨论模块的仓库

    +
    3. +

  3. 点击这里按下图配置仓库名称和你的评论所有类型
    giscus配置

    +
    4. +

  4. giscus 会自动从github获取对应的id
    giscus配置结果.png

    +
    5. +

  5. 拿到id后，我们就可以在_config.yml配置了

    +
    6. +
+
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
post:
  comments:  # 开启评论
    enable: true
    type: giscus # 选择评论插件类型

# 其他配置可以参考官网
giscus:
  repo: Hanchers/Hanchers.github.io
  repo-id: Mxxx
  category: Q&A
  category-id: Dxxxx
  theme-light: light
  theme-dark: dark
  mapping: pathname
  reactions-enabled: 1
  emit-metadata: 0
  input-position: top
  lang: zh-CN
+ +

效果：
giscus效果展示.png

+

遇到的问题

Q：前面都配置好后，发现评论模块加载不出来，打开F12,发现请求接口报错了：Discussion not found.
A: 很多人都遇到过这个问题，解决办法就是去仓库下手动加一条评论，等一会就好了。个人理解这里是github延迟导致的。

+

评价

    +
  1. 整个安装过程挺丝滑的
    2. +
  2. 数据完全托管到github，完全满足我的数据持久化和免费存储的需求
    3. +
  3. 效果也不错，响应速度中等
    4. +
  4. 还支持表情，挺惊喜的
    5. +
  5. 唯一的问题就是发表评论需要github登录，无法匿名评论
    6. +
  6. 基于github托管数据的插件里最推荐此款
    7. +
+

至此，基于github,完全免费的评论插件都比较完了，接下来就是需要第三方网站托管数据或者自建服务托管数据的评论插件了。

+

livere

来必力，没想到是一个韩国的网站，用来做评论数据托管等内容，需要注册。

+

来必力各版本的功能比较（2025-01-09）：
livere版本比较

+

安装过程

点击这里注册livere

+

注册并登录成功后，在这个页面选择city模块，然后点击“安装使用”
livere city 版本安装

+

安装成功后，会得到一个脚本注入代码。
livere安装代码
将上面的data-uid复制出来放到_config.yml配置里即可。

+
1
2
3
4
5
6
7
8
post:
  comments:  # 开启评论
    enable: true
    type: gitalk # 选择评论插件类型

# 其他配置可以参考官网
livere:
  uid: 'your uid'
+

效果：
livere评论模块效果
但是点击后，会弹出第三方账号登录窗口。
提示注册

+

评价

    +
  1. 免费，数据能够持久保存
    2. +
  2. 韩国网站，注册的过程中都是韩文，不太友好
    3. +
  3. 响应速度上，有点慢，但是比utterances快一点
    4. +
  4. 页面有点丑
    5. +
  5. 需要qq等账号注册才能使用，不太推荐
    6. +
+

畅言

畅言，一个国内比较老的评论插件，需要注册，可以免费存储数据。

+

安装过程

    +
  1. 点击官网，注册一个账号
    2. +
  2. 去官网工作台，创建一个【畅言云评】的应用
    3. +
  3. 进入应用详情，在后台总览里可以看到应用的id和密钥
    畅言云评id和密钥
    4. +
+

将上面的id和密钥复制出来，放到_config.yml配置里即可。

+
1
2
3
4
5
6
7
8
9
post:
  comments:  # 开启评论
    enable: true
    type: changyan # 选择评论插件类型

# 其他配置可以参考官网
changyan:
  appid: 'id'
  appkey: 'secret'
+

效果：
畅言云评效果

+

评价

    +
  1. 畅言的网站比较老了，但是注册过程还是很简单的
    2. +
  2. 从后台来看，对于评论的功能支持还是挺完善的，可以控评，也有很多其他的插件
    3. +
  3. 可以免费存储数据
    4. +
  4. 发布评论需要登录，门槛太高，pass.
    5. +
+

twikoo插件

一个简洁、安全、免费的静态网站评论系统。

+
    +
  • 免费搭建（使用云开发 / Vercel / 私有服务器作为评论后台）
    • +
  • 简单部署（支持云开发 / Vercel 一键部署）
    • +
+

这是一款私有化部署的评论插件，可以在自己的服务器上部署，官方也提供了一整套云部署的免费方案，可以自行选择。
twikoo的N种云部署方式

+

因为是私有化部署的方案，这就涉及到数据存储的问题，官方提供的方案是使用mongodb的免费存储服务，需要自行注册。

+

安装过程

无论哪一种方案都设计到mongodb数据库的申请，所以第一步就是要申请mongodb免费版。

+

mongodb申请

参考官方文章,写的很详细了。

+

netlify安装

因为网速和流量的原因，我选择的是netlify做我的评论插件托管云服务。

+
    +
  1. 打开 twikoojs/twikoo-netlify 点击 fork 将仓库 fork 到自己的账号下,后面netlify部署的时候会用到这个仓库。
    2. +
  2. 点击这里 注册netlify账号，可能需要翻墙，使用github账号登录。
    3. +
  3. netlify注册的时候可以选择仅授权上面fork的【twikoo-netlify】库
    4. +
  4. 进入netlify控制台，点击【import an existing site】，然后选择上面fork的【twikoo-netlify】库.
    netlify新建site页面
    5. +
  5. 配置环境变量，配置你的域名和mongodb的MONGODB_URI，值就是mongodb 申请里获得的nodejs 连接url
    配置mongodb环境变量
    6. +
  6. 点击deploy，等待部署完成。 然后请求你配置的域名https://xxxxx.netlify.app/ ，如果看到如下内容，说明部署成功。
    7. +
+
1
2
3
4
5
{
"code": 100,
"message": "Twikoo 云函数运行正常，请参考 https://twikoo.js.org/frontend.html 完成前端的配置",
"version": "1.6.41"
}
+
    +
  1. 配置完成后，就可以在_config.yml配置twikoo了。
    2. +
+
1
2
3
4
5
6
7
8
9
10
post:
  comments:  # 开启评论
    enable: true
    type: twikoo # 选择评论插件类型

# 其他配置可以参考官网
twikoo:
  envId: https://xxxxxxxxxx.netlify.app/.netlify/functions/twikoo
  region: ap-shanghai
  path: window.location.pathname
+

效果：
twikoo效果

+

其他部署方式

基于腾讯云的twikoo部署方案， 注意因为腾讯云免费额度已经没有了，这个方案已经失效，仅供学习参考。

+

评价

    +
  1. 因为是私有化部署，过程比较复杂
    2. +
  2. 整个过程都是免费的资源，满足我的免费持久化需求
    3. +
  3. 评论可以匿名，不用注册，比较友好
    4. +
  4. 页面也比较美观，支持评论的评论，最终选择了这个。
    5. +
+

最后pass掉的插件

    +
  • Valine: 基于 LeanCloud，这个有免费的存储空间。但是国内的LeanCloud 账号需要域名备案，要使用身份证等认证，接入很麻烦，遂放弃。
    • +
  • Waline: 从 Valine 衍生而来，放弃原因同上
    • +
  • Disqus: 国内用户直接使用容易被墙，直接放弃
    • +
  • remark42: 需要自建托管服务，直接放弃
    • +
+

总结

折腾了两天，终于把几款评论插件验证完了。

+

整体来看，有两款效果比较好，分别是twikoo和giscus。

+
    +
  • giscus: 安装比较简单，数据托管在github, 但评论需要github账号登录，适合那些快速上手的博主。
    • +
  • twikoo: 安装比较复杂，需要申请mongodb数据库，申请云服务免费资源，适合那些喜欢折腾的博主。
    • +
+

todo

    +
  • 等我的域名备案成功了，再尝试一下valine和waline
    • +
  • 找个时间试一下twikoo的私有化部署方式
    • +
+

最后，您觉得还有什么要补充的吗？

+ + +
+ +
+
+
+ +
+ + + + + + + + + + 网站 + + + + + + + + +
+ + +
+ + + #建站 + + #评论插件 + + #hexo + +
+ +
+ + + + + +
+
+
hexo建站增加自己的评论模块
+
https://www.hancher.top/2025/01/09/site-hexo-comment-feature/
+
+
+ +
+
作者
+
寒澈
+
+ + +
+
发布于
+
2025年1月9日
+
+ + +
+
更新于
+
2025年1月10日
+
+ + +
+
许可协议
+
+ + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+ + + + +
+
+ + +
+ +
+ +
+ + + + +
+ +
+ + + + +
+ + + +
+
+
+
+ +
+ + + + +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/404.html b/404.html new file mode 100644 index 00000000..385a6e3e --- /dev/null +++ b/404.html @@ -0,0 +1,396 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 页面不存在 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/CNAME b/CNAME new file mode 100644 index 00000000..c140c3b8 --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +www.hancher.top \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 00000000..60b420d1 --- /dev/null +++ b/LICENSE @@ -0,0 +1,32 @@ + Attribution-NonCommercial-NoDerivatives 4.0 International + + +You are free to: +Share — copy and redistribute the material in any medium or format + +The licensor cannot revoke these freedoms as long as you follow the license terms. + +Under the following terms: +Attribution — You must give appropriate credit , provide a link to the license, and indicate if changes were made . You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use. +NonCommercial — You may not use the material for commercial purposes . +NoDerivatives — If you remix, transform, or build upon the material, you may not distribute the modified material. +No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits. +Notices: +You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation . + +No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material. + + 署名—非商业性使用—禁止演绎 4.0 协议国际版 + +您可以自由地： +共享 — 在任何媒介以任何形式复制、发行本作品 +只要你遵守许可协议条款，许可人就无法收回你的这些权利。 +惟须遵守下列条件： +署名 — 您必须给出 适当的署名 ，提供指向本许可协议的链接，同时 标明是否（对原始作品）作了修改 。您可以用任何合理的方式来署名，但是不得以任何方式暗示许可人为您或您的使用背书。 +非商业性使用 — 您不得将本作品用于 商业目的 。 +禁止演绎 — 如果您 再混合、转换、或者基于该作品创作 ，您不可以分发修改作品。 +没有附加限制 — 您不得适用法律术语或者 技术措施 从而限制其他人做许可协议允许的事情。 +声明： +您不必因为公共领域的作品要素而遵守许可协议，或者您的使用被可适用的 例外或限制 所允许。 + +不提供担保。许可协议可能不会给与您意图使用的所必须的所有许可。例如，其他权利比如 形象权、隐私权或人格权 可能限制您如何使用作品。 diff --git a/about/index.html b/about/index.html new file mode 100644 index 00000000..2865f96b --- /dev/null +++ b/about/index.html @@ -0,0 +1,545 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 关于 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+ avatar +
+ +
+
+
+ + +
+
+
寒澈
+
一名喜欢经史哲的程序员
+
+ + + + + + + + + + + + + + + + + + + + + + + + qrcode + + + +
+
+
+ +
+
+ +
+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/ads.txt b/ads.txt new file mode 100644 index 00000000..a537292f --- /dev/null +++ b/ads.txt @@ -0,0 +1 @@ +google.com, pub-6938023200141592, DIRECT, f08c47fec0942fa0 \ No newline at end of file diff --git a/archives/2022/08/index.html b/archives/2022/08/index.html new file mode 100644 index 00000000..73eb19b5 --- /dev/null +++ b/archives/2022/08/index.html @@ -0,0 +1,436 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2022/09/index.html b/archives/2022/09/index.html new file mode 100644 index 00000000..2147e74b --- /dev/null +++ b/archives/2022/09/index.html @@ -0,0 +1,454 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2022/10/index.html b/archives/2022/10/index.html new file mode 100644 index 00000000..311c7900 --- /dev/null +++ b/archives/2022/10/index.html @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2022/11/index.html b/archives/2022/11/index.html new file mode 100644 index 00000000..011a8d61 --- /dev/null +++ b/archives/2022/11/index.html @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2022/index.html b/archives/2022/index.html new file mode 100644 index 00000000..07228c32 --- /dev/null +++ b/archives/2022/index.html @@ -0,0 +1,478 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2022/page/2/index.html b/archives/2022/page/2/index.html new file mode 100644 index 00000000..e40cb417 --- /dev/null +++ b/archives/2022/page/2/index.html @@ -0,0 +1,454 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/03/index.html b/archives/2023/03/index.html new file mode 100644 index 00000000..58255d0b --- /dev/null +++ b/archives/2023/03/index.html @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2023

+ + + +
通过frp实现内网穿透功能
+ + + + + +
mac系统通过homebrew安装nginx
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/04/index.html b/archives/2023/04/index.html new file mode 100644 index 00000000..509589b8 --- /dev/null +++ b/archives/2023/04/index.html @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/05/index.html b/archives/2023/05/index.html new file mode 100644 index 00000000..ecef348e --- /dev/null +++ b/archives/2023/05/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2023

+ + + +
AntPathMatcher VS PathPattern
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/06/index.html b/archives/2023/06/index.html new file mode 100644 index 00000000..cb7dfa37 --- /dev/null +++ b/archives/2023/06/index.html @@ -0,0 +1,442 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/07/index.html b/archives/2023/07/index.html new file mode 100644 index 00000000..bb12a8dc --- /dev/null +++ b/archives/2023/07/index.html @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2023

+ + + +
git优雅迁库的方式
+ + + + + +
jdbc反序列化漏洞修复
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/08/index.html b/archives/2023/08/index.html new file mode 100644 index 00000000..2ee7a1a1 --- /dev/null +++ b/archives/2023/08/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2023

+ + + +
java应用连接docker内的oracle时报ORA-01882错误
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/10/index.html b/archives/2023/10/index.html new file mode 100644 index 00000000..83e29616 --- /dev/null +++ b/archives/2023/10/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2023

+ + + +
linux定时任务crontab不执行的问题排查过程
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/11/index.html b/archives/2023/11/index.html new file mode 100644 index 00000000..0f0a344e --- /dev/null +++ b/archives/2023/11/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2023

+ + + +
springdoc-openapi的集成与常见问题
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/index.html b/archives/2023/index.html new file mode 100644 index 00000000..54be5f65 --- /dev/null +++ b/archives/2023/index.html @@ -0,0 +1,478 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2023/page/2/index.html b/archives/2023/page/2/index.html new file mode 100644 index 00000000..d11e9c9b --- /dev/null +++ b/archives/2023/page/2/index.html @@ -0,0 +1,454 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2024/05/index.html b/archives/2024/05/index.html new file mode 100644 index 00000000..09d281d4 --- /dev/null +++ b/archives/2024/05/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2024

+ + + +
如果让百度爬虫爬我的github博客
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2024/08/index.html b/archives/2024/08/index.html new file mode 100644 index 00000000..b6ad2a05 --- /dev/null +++ b/archives/2024/08/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 39 篇文章

+
+ + + + +

2024

+ + + +
mysql出现了waiting for global read lock 全局事务等待问题排查
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2024/12/index.html b/archives/2024/12/index.html new file mode 100644 index 00000000..1ac9395f --- /dev/null +++ b/archives/2024/12/index.html @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2024/index.html b/archives/2024/index.html new file mode 100644 index 00000000..6270bc0f --- /dev/null +++ b/archives/2024/index.html @@ -0,0 +1,436 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2025/01/index.html b/archives/2025/01/index.html new file mode 100644 index 00000000..5bb5171f --- /dev/null +++ b/archives/2025/01/index.html @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/2025/index.html b/archives/2025/index.html new file mode 100644 index 00000000..5ad188b0 --- /dev/null +++ b/archives/2025/index.html @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/index.html b/archives/index.html new file mode 100644 index 00000000..b3dbc7c8 --- /dev/null +++ b/archives/index.html @@ -0,0 +1,484 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/page/2/index.html b/archives/page/2/index.html new file mode 100644 index 00000000..f21caed8 --- /dev/null +++ b/archives/page/2/index.html @@ -0,0 +1,478 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/page/3/index.html b/archives/page/3/index.html new file mode 100644 index 00000000..f5ba0bc1 --- /dev/null +++ b/archives/page/3/index.html @@ -0,0 +1,481 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/archives/page/4/index.html b/archives/page/4/index.html new file mode 100644 index 00000000..1424a7f8 --- /dev/null +++ b/archives/page/4/index.html @@ -0,0 +1,472 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 归档 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/baidu_verify_codeva-GjrHaFHTj4.html b/baidu_verify_codeva-GjrHaFHTj4.html new file mode 100644 index 00000000..1428a04f --- /dev/null +++ b/baidu_verify_codeva-GjrHaFHTj4.html @@ -0,0 +1,411 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + page.title - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+ 6df1d59e70a1a1744baa138fc41fda1a + + + +
+ + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/beaudar.json b/beaudar.json new file mode 100644 index 00000000..e663b424 --- /dev/null +++ b/beaudar.json @@ -0,0 +1 @@ +{"origins":["https://hancher.top"]} \ No newline at end of file diff --git a/categories/dubbo/index.html b/categories/dubbo/index.html new file mode 100644 index 00000000..880500d2 --- /dev/null +++ b/categories/dubbo/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - dubbo - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
dubbo 在线平滑变更zookeeper
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/categories/index.html b/categories/index.html new file mode 100644 index 00000000..49556528 --- /dev/null +++ b/categories/index.html @@ -0,0 +1,1395 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + + + + + +
+ + + + + +
+ + + + + 10 + + +
+ + + + +
+ + + + + + linux定时任务crontab不执行的问题排查过程 + + + + + + + java应用连接docker内的oracle时报ORA-01882错误 + + + + + + + spring服务form表单内容过大导致后端参数接收为null情况 + + + + + + + 通过frp实现内网穿透功能 + + + + + + + 如何写好java注释 + + + +
+ + + + + + +
+ + + + + 2 + + +
+ + + +
+ + + + + + es在java工程中如何支持自定义的json格式的DSL + + + + + + + Elasticsearch重建索引 + + + +
+ + +
+
+ + + + +
+ + + + + 2 + + +
+ + + +
+ + + + + + git优雅迁库的方式 + + + + + + + macOS升级13 ventura后git无法使用的解决办法 + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + mac系统通过homebrew安装nginx + + + +
+ + +
+
+ + +
+
+ + + + +
+ + + + + 7 + + +
+ + + +
+ + + + + + hexo建站增加自己的评论模块 + + + + + + + jekyll迁移到Hexo博客架构全过程 + + + + + + + 2025年博客更新计划 + + + + + + + 如果让百度爬虫爬我的github博客 + + + + + + + 使用私有仓库发布 GitHub Pages + + + + + + + beaudar评论插件及常见问题解决 + + + + + + + hello world + + + +
+ + +
+
+ + + + +
+ + + + + 7 + + +
+ + + +
+ + + + + + linux安装ClamAV杀毒软件然后扫毒 + + + + + + + jdbc反序列化漏洞修复 + + + + + + + CORS跨域攻击与修复 + + + + + + + 存储XSS问题与修复 + + + + + + + 网站任意文件下载或读取 + + + + + + + URL存在http host头攻击漏洞的解决办法 + + + + + + + 中间件版本号泄露问题修复 + + + +
+ + +
+
+ + + + +
+ + + + + 4 + + +
+ + + + +
+ + +
+ + + + + + +
+ + + + + 2 + + +
+ + + +
+ + + + + + JDK 20新特性简介 + + + + + + + JDK 19新特性简介 + + + +
+ + +
+
+ + + + +
+ + + + + 2 + + +
+ + + +
+ + + + + + java中常用的工具类(2) System + + + + + + + java中常用的工具类(1) Objects + + + +
+ + +
+
+ + +
+
+ + + + +
+ + + + + 2 + + +
+ + + +
+ + + + + + redis常用命令总结 + + + + + + + redis脚本命令 + + + +
+ + +
+
+ + + + +
+ + + + + 2 + + +
+ + + +
+ + + + + + springdoc-openapi的集成与常见问题 + + + + + + + AntPathMatcher VS PathPattern + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + 算法套路 + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + 如何给bash脚本进行加密？ + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + dubbo 在线平滑变更zookeeper + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + mysql出现了waiting for global read lock 全局事务等待问题排查 + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + + +
+ + +
+ + + + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + 鸿蒙应用开发:"request data error"问题解决 + + + +
+ + +
+
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + 有意思的小问题,java代码过长 + + + +
+ + +
+
+ + + + +
+ + + + + 1 + + +
+ + + +
+ + + + + + 西部数据提供免费版Paragon实现与mac电脑的读写 + + + +
+ + +
+
+ +
+ + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/categories/java/index.html b/categories/java/index.html new file mode 100644 index 00000000..f885a15e --- /dev/null +++ b/categories/java/index.html @@ -0,0 +1,439 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - java - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/java/java\347\211\210\346\234\254\347\211\271\346\200\247/index.html" "b/categories/java/java\347\211\210\346\234\254\347\211\271\346\200\247/index.html" new file mode 100644 index 00000000..f17eabd1 --- /dev/null +++ "b/categories/java/java\347\211\210\346\234\254\347\211\271\346\200\247/index.html" @@ -0,0 +1,427 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - java版本特性 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2023

+ + + +
JDK 20新特性简介
+ + + + +

2022

+ + + +
JDK 19新特性简介
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/java/\345\267\245\345\205\267\347\261\273/index.html" "b/categories/java/\345\267\245\345\205\267\347\261\273/index.html" new file mode 100644 index 00000000..2da5a938 --- /dev/null +++ "b/categories/java/\345\267\245\345\205\267\347\261\273/index.html" @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 工具类 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2022

+ + + +
java中常用的工具类(2) System
+ + + + + +
java中常用的工具类(1) Objects
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/java\345\274\202\345\270\270/index.html" "b/categories/java\345\274\202\345\270\270/index.html" new file mode 100644 index 00000000..c9a75084 --- /dev/null +++ "b/categories/java\345\274\202\345\270\270/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - java异常 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
有意思的小问题,java代码过长
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/categories/linux/index.html b/categories/linux/index.html new file mode 100644 index 00000000..a8ad26e4 --- /dev/null +++ b/categories/linux/index.html @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - linux - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
如何给bash脚本进行加密？
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/categories/redis/index.html b/categories/redis/index.html new file mode 100644 index 00000000..cf4c77e5 --- /dev/null +++ b/categories/redis/index.html @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - redis - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2022

+ + + +
redis常用命令总结
+ + + + + +
redis脚本命令
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/categories/spring/index.html b/categories/spring/index.html new file mode 100644 index 00000000..6b3d8793 --- /dev/null +++ b/categories/spring/index.html @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - spring - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2023

+ + + +
springdoc-openapi的集成与常见问题
+ + + + + +
AntPathMatcher VS PathPattern
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\345\256\211\345\205\250/index.html" "b/categories/\345\256\211\345\205\250/index.html" new file mode 100644 index 00000000..e2e8c337 --- /dev/null +++ "b/categories/\345\256\211\345\205\250/index.html" @@ -0,0 +1,457 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 安全 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\346\225\260\346\215\256\345\272\223/index.html" "b/categories/\346\225\260\346\215\256\345\272\223/index.html" new file mode 100644 index 00000000..e271b12d --- /dev/null +++ "b/categories/\346\225\260\346\215\256\345\272\223/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 数据库 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2024

+ + + +
mysql出现了waiting for global read lock 全局事务等待问题排查
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\224\237\346\264\273/index.html" "b/categories/\347\224\237\346\264\273/index.html" new file mode 100644 index 00000000..77efdfe6 --- /dev/null +++ "b/categories/\347\224\237\346\264\273/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 生活 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2024

+ + + +
西部数据提供免费版Paragon实现与mac电脑的读写
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\256\227\346\263\225/index.html" "b/categories/\347\256\227\346\263\225/index.html" new file mode 100644 index 00000000..96b01aa2 --- /dev/null +++ "b/categories/\347\256\227\346\263\225/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 算法 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
算法套路
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\274\226\347\250\213\344\272\272\347\224\237/Elasticsearch/index.html" "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/Elasticsearch/index.html" new file mode 100644 index 00000000..f92d6ca0 --- /dev/null +++ "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/Elasticsearch/index.html" @@ -0,0 +1,424 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - Elasticsearch - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2022

+ + + +
es在java工程中如何支持自定义的json格式的DSL
+ + + + + +
Elasticsearch重建索引
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\274\226\347\250\213\344\272\272\347\224\237/git/index.html" "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/git/index.html" new file mode 100644 index 00000000..1ad359c0 --- /dev/null +++ "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/git/index.html" @@ -0,0 +1,427 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - git - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2023

+ + + +
git优雅迁库的方式
+ + + + +

2022

+ + + +
macOS升级13 ventura后git无法使用的解决办法
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\274\226\347\250\213\344\272\272\347\224\237/index.html" "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/index.html" new file mode 100644 index 00000000..2b76c5cf --- /dev/null +++ "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/index.html" @@ -0,0 +1,475 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 编程人生 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\274\226\347\250\213\344\272\272\347\224\237/nginx/index.html" "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/nginx/index.html" new file mode 100644 index 00000000..4609fbc9 --- /dev/null +++ "b/categories/\347\274\226\347\250\213\344\272\272\347\224\237/nginx/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - nginx - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
mac系统通过homebrew安装nginx
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\347\275\221\347\253\231/index.html" "b/categories/\347\275\221\347\253\231/index.html" new file mode 100644 index 00000000..3cedf941 --- /dev/null +++ "b/categories/\347\275\221\347\253\231/index.html" @@ -0,0 +1,460 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 网站 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\351\270\277\350\222\231/app/index.html" "b/categories/\351\270\277\350\222\231/app/index.html" new file mode 100644 index 00000000..d576bef7 --- /dev/null +++ "b/categories/\351\270\277\350\222\231/app/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - app - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
鸿蒙应用开发:"request data error"问题解决
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/categories/\351\270\277\350\222\231/index.html" "b/categories/\351\270\277\350\222\231/index.html" new file mode 100644 index 00000000..8daaf65b --- /dev/null +++ "b/categories/\351\270\277\350\222\231/index.html" @@ -0,0 +1,418 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 分类 - 鸿蒙 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
鸿蒙应用开发:"request data error"问题解决
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/css/gitalk.css b/css/gitalk.css new file mode 100644 index 00000000..a268f1d2 --- /dev/null +++ b/css/gitalk.css @@ -0,0 +1,546 @@ +@font-face { + font-family: octicons-link; + src: url(data:font/woff;charset=utf-8;base64,d09GRgABAAAAAAZwABAAAAAACFQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEU0lHAAAGaAAAAAgAAAAIAAAAAUdTVUIAAAZcAAAACgAAAAoAAQAAT1MvMgAAAyQAAABJAAAAYFYEU3RjbWFwAAADcAAAAEUAAACAAJThvmN2dCAAAATkAAAABAAAAAQAAAAAZnBnbQAAA7gAAACyAAABCUM+8IhnYXNwAAAGTAAAABAAAAAQABoAI2dseWYAAAFsAAABPAAAAZwcEq9taGVhZAAAAsgAAAA0AAAANgh4a91oaGVhAAADCAAAABoAAAAkCA8DRGhtdHgAAAL8AAAADAAAAAwGAACfbG9jYQAAAsAAAAAIAAAACABiATBtYXhwAAACqAAAABgAAAAgAA8ASm5hbWUAAAToAAABQgAAAlXu73sOcG9zdAAABiwAAAAeAAAAME3QpOBwcmVwAAAEbAAAAHYAAAB/aFGpk3jaTY6xa8JAGMW/O62BDi0tJLYQincXEypYIiGJjSgHniQ6umTsUEyLm5BV6NDBP8Tpts6F0v+k/0an2i+itHDw3v2+9+DBKTzsJNnWJNTgHEy4BgG3EMI9DCEDOGEXzDADU5hBKMIgNPZqoD3SilVaXZCER3/I7AtxEJLtzzuZfI+VVkprxTlXShWKb3TBecG11rwoNlmmn1P2WYcJczl32etSpKnziC7lQyWe1smVPy/Lt7Kc+0vWY/gAgIIEqAN9we0pwKXreiMasxvabDQMM4riO+qxM2ogwDGOZTXxwxDiycQIcoYFBLj5K3EIaSctAq2kTYiw+ymhce7vwM9jSqO8JyVd5RH9gyTt2+J/yUmYlIR0s04n6+7Vm1ozezUeLEaUjhaDSuXHwVRgvLJn1tQ7xiuVv/ocTRF42mNgZGBgYGbwZOBiAAFGJBIMAAizAFoAAABiAGIAznjaY2BkYGAA4in8zwXi+W2+MjCzMIDApSwvXzC97Z4Ig8N/BxYGZgcgl52BCSQKAA3jCV8CAABfAAAAAAQAAEB42mNgZGBg4f3vACQZQABIMjKgAmYAKEgBXgAAeNpjYGY6wTiBgZWBg2kmUxoDA4MPhGZMYzBi1AHygVLYQUCaawqDA4PChxhmh/8ODDEsvAwHgMKMIDnGL0x7gJQCAwMAJd4MFwAAAHjaY2BgYGaA4DAGRgYQkAHyGMF8NgYrIM3JIAGVYYDT+AEjAwuDFpBmA9KMDEwMCh9i/v8H8sH0/4dQc1iAmAkALaUKLgAAAHjaTY9LDsIgEIbtgqHUPpDi3gPoBVyRTmTddOmqTXThEXqrob2gQ1FjwpDvfwCBdmdXC5AVKFu3e5MfNFJ29KTQT48Ob9/lqYwOGZxeUelN2U2R6+cArgtCJpauW7UQBqnFkUsjAY/kOU1cP+DAgvxwn1chZDwUbd6CFimGXwzwF6tPbFIcjEl+vvmM/byA48e6tWrKArm4ZJlCbdsrxksL1AwWn/yBSJKpYbq8AXaaTb8AAHja28jAwOC00ZrBeQNDQOWO//sdBBgYGRiYWYAEELEwMTE4uzo5Zzo5b2BxdnFOcALxNjA6b2ByTswC8jYwg0VlNuoCTWAMqNzMzsoK1rEhNqByEyerg5PMJlYuVueETKcd/89uBpnpvIEVomeHLoMsAAe1Id4AAAAAAAB42oWQT07CQBTGv0JBhagk7HQzKxca2sJCE1hDt4QF+9JOS0nbaaYDCQfwCJ7Au3AHj+LO13FMmm6cl7785vven0kBjHCBhfpYuNa5Ph1c0e2Xu3jEvWG7UdPDLZ4N92nOm+EBXuAbHmIMSRMs+4aUEd4Nd3CHD8NdvOLTsA2GL8M9PODbcL+hD7C1xoaHeLJSEao0FEW14ckxC+TU8TxvsY6X0eLPmRhry2WVioLpkrbp84LLQPGI7c6sOiUzpWIWS5GzlSgUzzLBSikOPFTOXqly7rqx0Z1Q5BAIoZBSFihQYQOOBEdkCOgXTOHA07HAGjGWiIjaPZNW13/+lm6S9FT7rLHFJ6fQbkATOG1j2OFMucKJJsxIVfQORl+9Jyda6Sl1dUYhSCm1dyClfoeDve4qMYdLEbfqHf3O/AdDumsjAAB42mNgYoAAZQYjBmyAGYQZmdhL8zLdDEydARfoAqIAAAABAAMABwAKABMAB///AA8AAQAAAAAAAAAAAAAAAAABAAAAAA==) format('woff'); +} +/* variables */ +/* functions & mixins */ +/* variables - calculated */ +/* styles */ +.gt-container { + -webkit-box-sizing: border-box; + box-sizing: border-box; + font-size: 16px; + /* loader */ + /* error */ + /* initing */ + /* no int */ + /* link */ + /* meta */ + /* popup */ + /* header */ + /* comments */ + /* comment */ +} +.gt-container * { + -webkit-box-sizing: border-box; + box-sizing: border-box; +} +.gt-container a { + color: #6190e8; +} +.gt-container a:hover { + color: #81a6ed; + border-color: #81a6ed; +} +.gt-container a.is--active { + color: #333; + cursor: default !important; +} +.gt-container a.is--active:hover { + color: #333; +} +.gt-container .hide { + display: none !important; +} +.gt-container .gt-svg { + display: inline-block; + width: 1em; + height: 1em; + vertical-align: sub; +} +.gt-container .gt-svg svg { + width: 100%; + height: 100%; + fill: #6190e8; +} +.gt-container .gt-ico { + display: inline-block; +} +.gt-container .gt-ico-text { + margin-left: 0.3125em; +} +.gt-container .gt-ico-github { + width: 100%; + height: 100%; +} +.gt-container .gt-ico-github .gt-svg { + width: 100%; + height: 100%; +} +.gt-container .gt-ico-github svg { + fill: inherit; +} +.gt-container .gt-spinner { + position: relative; +} +.gt-container .gt-spinner::before { + content: ''; + -webkit-box-sizing: border-box; + box-sizing: border-box; + position: absolute; + top: 3px; + width: 0.75em; + height: 0.75em; + margin-top: -0.1875em; + margin-left: -0.375em; + border-radius: 50%; + border: 1px solid #fff; + border-top-color: #6190e8; + -webkit-animation: gt-kf-rotate 0.6s linear infinite; + animation: gt-kf-rotate 0.6s linear infinite; +} +.gt-container .gt-loader { + position: relative; + border: 1px solid #999; + -webkit-animation: ease gt-kf-rotate 1.5s infinite; + animation: ease gt-kf-rotate 1.5s infinite; + display: inline-block; + font-style: normal; + width: 1.75em; + height: 1.75em; + line-height: 1.75em; + border-radius: 50%; +} +.gt-container .gt-loader:before { + content: ''; + position: absolute; + display: block; + top: 0; + left: 50%; + margin-top: -0.1875em; + margin-left: -0.1875em; + width: 0.375em; + height: 0.375em; + background-color: #999; + border-radius: 50%; +} +.gt-container .gt-avatar { + display: inline-block; + width: 3.125em; + height: 3.125em; +} +@media (max-width: 479px) { + .gt-container .gt-avatar { + width: 2em; + height: 2em; + } +} +.gt-container .gt-avatar img { + width: 100%; + height: auto; + border-radius: 3px; +} +.gt-container .gt-avatar-github { + width: 3em; + height: 3em; +} +@media (max-width: 479px) { + .gt-container .gt-avatar-github { + width: 1.875em; + height: 1.875em; + } +} +.gt-container .gt-btn { + padding: 0.75em 1.25em; + display: inline-block; + line-height: 1; + text-decoration: none; + white-space: nowrap; + cursor: pointer; + border: 1px solid #6190e8; + border-radius: 5px; + background-color: #6190e8; + color: #fff; + outline: none; + font-size: 0.75em; +} +.gt-container .gt-btn-text { + font-weight: 400; +} +.gt-container .gt-btn-loading { + position: relative; + margin-left: 0.5em; + display: inline-block; + width: 0.75em; + height: 1em; + vertical-align: top; +} +.gt-container .gt-btn.is--disable { + cursor: not-allowed; + opacity: 0.5; +} +.gt-container .gt-btn-login { + margin-right: 0; +} +.gt-container .gt-btn-preview { + background-color: #fff; + color: #6190e8; +} +.gt-container .gt-btn-preview:hover { + background-color: #f2f2f2; + border-color: #81a6ed; +} +.gt-container .gt-btn-public:hover { + background-color: #81a6ed; + border-color: #81a6ed; +} +.gt-container .gt-error { + text-align: center; + margin: 0.625em; + color: #ff3860; +} +.gt-container .gt-initing { + padding: 1.25em 0; + text-align: center; +} +.gt-container .gt-initing-text { + margin: 0.625em auto; + font-size: 92%; +} +.gt-container .gt-no-init { + padding: 1.25em 0; + text-align: center; +} +.gt-container .gt-link { + border-bottom: 1px dotted #6190e8; +} +.gt-container .gt-link-counts, +.gt-container .gt-link-project { + text-decoration: none; +} +.gt-container .gt-meta { + margin: 1.25em 0; + padding: 1em 0; + position: relative; + border-bottom: 1px solid #e9e9e9; + font-size: 1em; + position: relative; + z-index: 10; +} +.gt-container .gt-meta:before, +.gt-container .gt-meta:after { + content: " "; + display: table; +} +.gt-container .gt-meta:after { + clear: both; +} +.gt-container .gt-counts { + margin: 0 0.625em 0 0; +} +.gt-container .gt-user { + float: right; + margin: 0; + font-size: 92%; +} +.gt-container .gt-user-pic { + width: 16px; + height: 16px; + vertical-align: top; + margin-right: 0.5em; +} +.gt-container .gt-user-inner { + display: inline-block; + cursor: pointer; +} +.gt-container .gt-user .gt-ico { + margin: 0 0 0 0.3125em; +} +.gt-container .gt-user .gt-ico svg { + fill: inherit; +} +.gt-container .gt-user .is--poping .gt-ico svg { + fill: #6190e8; +} +.gt-container .gt-version { + color: #a1a1a1; + margin-left: 0.375em; +} +.gt-container .gt-copyright { + margin: 0 0.9375em 0.5em; + border-top: 1px solid #e9e9e9; + padding-top: 0.5em; +} +.gt-container .gt-popup { + position: absolute; + right: 0; + top: 2.375em; + background: #fff; + display: inline-block; + border: 1px solid #e9e9e9; + padding: 0.625em 0; + font-size: 0.875em; + letter-spacing: 0.5px; +} +.gt-container .gt-popup .gt-action { + cursor: pointer; + display: block; + margin: 0.5em 0; + padding: 0 1.125em; + position: relative; + text-decoration: none; +} +.gt-container .gt-popup .gt-action.is--active:before { + content: ''; + width: 0.25em; + height: 0.25em; + background: #6190e8; + position: absolute; + left: 0.5em; + top: 0.4375em; +} +.gt-container .gt-header { + position: relative; + display: -webkit-box; + display: -ms-flexbox; + display: flex; +} +.gt-container .gt-header-comment { + -webkit-box-flex: 1; + -ms-flex: 1; + flex: 1; + margin-left: 1.25em; +} +@media (max-width: 479px) { + .gt-container .gt-header-comment { + margin-left: 0.875em; + } +} +.gt-container .gt-header-textarea { + padding: 0.75em; + display: block; + -webkit-box-sizing: border-box; + box-sizing: border-box; + width: 100%; + min-height: 5.125em; + max-height: 15em; + border-radius: 5px; + border: 1px solid rgba(0,0,0,0.1); + font-size: 0.875em; + word-wrap: break-word; + resize: vertical; + background-color: #f6f6f6; + outline: none; + -webkit-transition: all 0.25s ease; + transition: all 0.25s ease; +} +.gt-container .gt-header-textarea:hover { + background-color: #fbfbfb; +} +.gt-container .gt-header-preview { + padding: 0.75em; + border-radius: 5px; + border: 1px solid rgba(0,0,0,0.1); + background-color: #f6f6f6; +} +.gt-container .gt-header-controls { + position: relative; + margin: 0.75em 0 0; +} +.gt-container .gt-header-controls:before, +.gt-container .gt-header-controls:after { + content: " "; + display: table; +} +.gt-container .gt-header-controls:after { + clear: both; +} +@media (max-width: 479px) { + .gt-container .gt-header-controls { + margin: 0; + } +} +.gt-container .gt-header-controls-tip { + font-size: 0.875em; + color: #6190e8; + text-decoration: none; + vertical-align: sub; +} +@media (max-width: 479px) { + .gt-container .gt-header-controls-tip { + display: none; + } +} +.gt-container .gt-header-controls .gt-btn { + float: right; + margin-left: 1.25em; +} +@media (max-width: 479px) { + .gt-container .gt-header-controls .gt-btn { + float: none; + width: 100%; + margin: 0.75em 0 0; + } +} +.gt-container:after { + content: ''; + position: fixed; + bottom: 100%; + left: 0; + right: 0; + top: 0; + opacity: 0; +} +.gt-container.gt-input-focused { + position: relative; +} +.gt-container.gt-input-focused:after { + content: ''; + position: fixed; + bottom: 0%; + left: 0; + right: 0; + top: 0; + background: #000; + opacity: 0.6; + -webkit-transition: opacity 0.3s, bottom 0s; + transition: opacity 0.3s, bottom 0s; + z-index: 9999; +} +.gt-container.gt-input-focused .gt-header-comment { + z-index: 10000; +} +.gt-container .gt-comments { + padding-top: 1.25em; +} +.gt-container .gt-comments-null { + text-align: center; +} +.gt-container .gt-comments-controls { + margin: 1.25em 0; + text-align: center; +} +.gt-container .gt-comment { + position: relative; + padding: 0.625em 0; + display: -webkit-box; + display: -ms-flexbox; + display: flex; +} +.gt-container .gt-comment-content { + -webkit-box-flex: 1; + -ms-flex: 1; + flex: 1; + margin-left: 1.25em; + padding: 0.75em 1em; + background-color: #f9f9f9; + overflow: auto; + -webkit-transition: all ease 0.25s; + transition: all ease 0.25s; +} +.gt-container .gt-comment-content:hover { + -webkit-box-shadow: 0 0.625em 3.75em 0 #f4f4f4; + box-shadow: 0 0.625em 3.75em 0 #f4f4f4; +} +@media (max-width: 479px) { + .gt-container .gt-comment-content { + margin-left: 0.875em; + padding: 0.625em 0.75em; + } +} +.gt-container .gt-comment-header { + margin-bottom: 0.5em; + font-size: 0.875em; + position: relative; +} +.gt-container .gt-comment-block-1 { + float: right; + height: 1.375em; + width: 2em; +} +.gt-container .gt-comment-block-2 { + float: right; + height: 1.375em; + width: 4em; +} +.gt-container .gt-comment-username { + font-weight: 500; + color: #6190e8; + text-decoration: none; +} +.gt-container .gt-comment-username:hover { + text-decoration: underline; +} +.gt-container .gt-comment-text { + margin-left: 0.5em; + color: #a1a1a1; +} +.gt-container .gt-comment-date { + margin-left: 0.5em; + color: #a1a1a1; +} +.gt-container .gt-comment-like, +.gt-container .gt-comment-edit, +.gt-container .gt-comment-reply { + position: absolute; + height: 1.375em; +} +.gt-container .gt-comment-like:hover, +.gt-container .gt-comment-edit:hover, +.gt-container .gt-comment-reply:hover { + cursor: pointer; +} +.gt-container .gt-comment-like { + top: 0; + right: 2em; +} +.gt-container .gt-comment-edit, +.gt-container .gt-comment-reply { + top: 0; + right: 0; +} +.gt-container .gt-comment-body { + color: #333 !important; +} +.gt-container .gt-comment-body .email-hidden-toggle a { + display: inline-block; + height: 12px; + padding: 0 9px; + font-size: 12px; + font-weight: 600; + line-height: 6px; + color: #444d56; + text-decoration: none; + vertical-align: middle; + background: #dfe2e5; + border-radius: 1px; +} +.gt-container .gt-comment-body .email-hidden-toggle a:hover { + background-color: #c6cbd1; +} +.gt-container .gt-comment-body .email-hidden-reply { + display: none; + white-space: pre-wrap; +} +.gt-container .gt-comment-body .email-hidden-reply .email-signature-reply { + padding: 0 15px; + margin: 15px 0; + color: #586069; + border-left: 4px solid #dfe2e5; +} +.gt-container .gt-comment-body .email-hidden-reply.expanded { + display: block; +} +.gt-container .gt-comment-admin .gt-comment-content { + background-color: #f6f9fe; +} +@-webkit-keyframes gt-kf-rotate { + 0% { + -webkit-transform: rotate(0); + transform: rotate(0); + } + 100% { + -webkit-transform: rotate(360deg); + transform: rotate(360deg); + } +} +@keyframes gt-kf-rotate { + 0% { + -webkit-transform: rotate(0); + transform: rotate(0); + } + 100% { + -webkit-transform: rotate(360deg); + transform: rotate(360deg); + } +} diff --git a/css/highlight-dark.css b/css/highlight-dark.css new file mode 100644 index 00000000..13d6ac81 --- /dev/null +++ b/css/highlight-dark.css @@ -0,0 +1,62 @@ +pre code.hljs { + display: block; + overflow-x: auto; + padding: 1em +} +code.hljs { + padding: 3px 5px +} +/* + +Dark style from softwaremaniacs.org (c) Ivan Sagalaev + +*/ +.hljs { + color: #ddd; + background: #303030 +} +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-section, +.hljs-link { + color: white +} +.hljs-subst { + /* default */ + +} +.hljs-string, +.hljs-title, +.hljs-name, +.hljs-type, +.hljs-attribute, +.hljs-symbol, +.hljs-bullet, +.hljs-built_in, +.hljs-addition, +.hljs-variable, +.hljs-template-tag, +.hljs-template-variable { + color: #d88 +} +.hljs-comment, +.hljs-quote, +.hljs-deletion, +.hljs-meta { + color: #979797 +} +.hljs-keyword, +.hljs-selector-tag, +.hljs-literal, +.hljs-title, +.hljs-section, +.hljs-doctag, +.hljs-type, +.hljs-name, +.hljs-strong { + font-weight: bold +} +.hljs-emphasis { + font-style: italic +} diff --git a/css/highlight.css b/css/highlight.css new file mode 100644 index 00000000..acd5468e --- /dev/null +++ b/css/highlight.css @@ -0,0 +1,118 @@ +pre code.hljs { + display: block; + overflow-x: auto; + padding: 1em +} +code.hljs { + padding: 3px 5px +} +/*! + Theme: GitHub + Description: Light theme as seen on github.com + Author: github.com + Maintainer: @Hirse + Updated: 2021-05-15 + + Outdated base version: https://github.com/primer/github-syntax-light + Current colors taken from GitHub's CSS +*/ +.hljs { + color: #24292e; + background: #ffffff +} +.hljs-doctag, +.hljs-keyword, +.hljs-meta .hljs-keyword, +.hljs-template-tag, +.hljs-template-variable, +.hljs-type, +.hljs-variable.language_ { + /* prettylights-syntax-keyword */ + color: #d73a49 +} +.hljs-title, +.hljs-title.class_, +.hljs-title.class_.inherited__, +.hljs-title.function_ { + /* prettylights-syntax-entity */ + color: #6f42c1 +} +.hljs-attr, +.hljs-attribute, +.hljs-literal, +.hljs-meta, +.hljs-number, +.hljs-operator, +.hljs-variable, +.hljs-selector-attr, +.hljs-selector-class, +.hljs-selector-id { + /* prettylights-syntax-constant */ + color: #005cc5 +} +.hljs-regexp, +.hljs-string, +.hljs-meta .hljs-string { + /* prettylights-syntax-string */ + color: #032f62 +} +.hljs-built_in, +.hljs-symbol { + /* prettylights-syntax-variable */ + color: #e36209 +} +.hljs-comment, +.hljs-code, +.hljs-formula { + /* prettylights-syntax-comment */ + color: #6a737d +} +.hljs-name, +.hljs-quote, +.hljs-selector-tag, +.hljs-selector-pseudo { + /* prettylights-syntax-entity-tag */ + color: #22863a +} +.hljs-subst { + /* prettylights-syntax-storage-modifier-import */ + color: #24292e +} +.hljs-section { + /* prettylights-syntax-markup-heading */ + color: #005cc5; + font-weight: bold +} +.hljs-bullet { + /* prettylights-syntax-markup-list */ + color: #735c0f +} +.hljs-emphasis { + /* prettylights-syntax-markup-italic */ + color: #24292e; + font-style: italic +} +.hljs-strong { + /* prettylights-syntax-markup-bold */ + color: #24292e; + font-weight: bold +} +.hljs-addition { + /* prettylights-syntax-markup-inserted */ + color: #22863a; + background-color: #f0fff4 +} +.hljs-deletion { + /* prettylights-syntax-markup-deleted */ + color: #b31d28; + background-color: #ffeef0 +} +.hljs-char.escape_, +.hljs-link, +.hljs-params, +.hljs-property, +.hljs-punctuation, +.hljs-tag { + /* purposely ignored */ + +} diff --git a/css/main.css b/css/main.css new file mode 100644 index 00000000..6d582e06 --- /dev/null +++ b/css/main.css @@ -0,0 +1,2241 @@ +.anchorjs-link { + text-decoration: none !important; + transition: opacity 0.2s ease-in-out; +} +.markdown-body h1:hover > .anchorjs-link, +h2:hover > .anchorjs-link, +h3:hover > .anchorjs-link, +h4:hover > .anchorjs-link, +h5:hover > .anchorjs-link, +h6:hover > .anchorjs-link { + opacity: 1; +} +.banner { + height: 100%; + position: relative; + overflow: hidden; + cursor: default; +} +.banner .mask { + position: absolute; + width: 100%; + height: 100%; + background-color: rgba(0,0,0,0.3); +} +.banner[parallax="true"] { + will-change: transform; + -webkit-transform-style: preserve-3d; + -webkit-backface-visibility: hidden; + transition: transform 0.05s ease-out; +} +@media (max-width: 100vh) { + .header-inner { + max-height: 100vw; + } + #board { + margin-top: -1rem !important; + } +} +@media (max-width: 79.99vh) { + .scroll-down-bar { + display: none; + } +} +#board { + position: relative; + margin-top: -2rem; + padding: 3rem 0; + background-color: var(--board-bg-color); + transition: background-color 0.2s ease-in-out; + border-radius: 0.5rem; + z-index: 3; + -webkit-box-shadow: 0 12px 15px 0 rgba(0,0,0,0.24), 0 17px 50px 0 rgba(0,0,0,0.19); + box-shadow: 0 12px 15px 0 rgba(0,0,0,0.24), 0 17px 50px 0 rgba(0,0,0,0.19); +} +.code-widget { + display: inline-block; + background-color: transparent; + font-size: 0.75rem; + line-height: 1; + font-weight: bold; + padding: 0.3rem 0.1rem 0.1rem 0.1rem; + position: absolute; + right: 0.45rem; + top: 0.15rem; + z-index: 1; +} +.code-widget-light { + color: #999; +} +.code-widget-dark { + color: #bababa; +} +.copy-btn { + cursor: pointer; + user-select: none; + -webkit-appearance: none; + outline: none; +} +.copy-btn > i { + font-size: 0.75rem !important; + font-weight: 400; + margin-right: 0.15rem; + opacity: 0; + transition: opacity 0.2s ease-in-out; +} +.markdown-body pre:hover > .copy-btn > i { + opacity: 0.9; +} +.markdown-body pre:hover > .copy-btn, +.markdown-body pre:not(:hover) > .copy-btn { + outline: none; +} +.license-box { + background-color: rgba(27,31,35,0.05); + transition: background-color 0.2s ease-in-out; + border-radius: 4px; + font-size: 0.9rem; + overflow: hidden; + padding: 1.25rem; + position: relative; + z-index: 1; +} +.license-box .license-icon { + position: absolute; + top: 50%; + left: 100%; +} +.license-box .license-icon::after { + content: "\e8e4"; + font-size: 12.5rem; + line-height: 1; + opacity: 0.1; + position: relative; + left: -0.85em; + bottom: 0.5em; + z-index: -1; +} +.license-box .license-title { + margin-bottom: 1rem; +} +.license-box .license-title div:nth-child(1) { + line-height: 1.2; + margin-bottom: 0.25rem; +} +.license-box .license-title div:nth-child(2) { + color: var(--sec-text-color); + font-size: 0.8rem; +} +.license-box .license-meta { + align-items: center; + display: flex; + flex-wrap: wrap; + justify-content: flex-start; +} +.license-box .license-meta .license-meta-item { + align-items: center; + justify-content: center; + margin-right: 1.5rem; +} +.license-box .license-meta .license-meta-item div:nth-child(1) { + color: var(--sec-text-color); + font-size: 0.8rem; + font-weight: normal; +} +.license-box .license-meta .license-meta-item i.iconfont { + font-size: 1rem; +} +@media (max-width: 575px) and (min-width: 425px) { + .license-box .license-meta .license-meta-item { + display: flex; + justify-content: flex-start; + flex-wrap: wrap; + font-size: 0.8rem; + flex: 0 0 50%; + max-width: 50%; + margin-right: 0; + } + .license-box .license-meta .license-meta-item div:nth-child(1) { + margin-right: 0.5rem; + } + .license-box .license-meta .license-meta-date { + order: -1; + } +} +@media (max-width: 424px) { + .license-box::after { + top: -65px; + } + .license-box .license-meta { + flex-direction: column; + align-items: flex-start; + } + .license-box .license-meta .license-meta-item { + display: flex; + flex-wrap: wrap; + font-size: 0.8rem; + } + .license-box .license-meta .license-meta-item div:nth-child(1) { + margin-right: 0.5rem; + } +} +.footer-inner { + padding: 3rem 0 1rem 0; + text-align: center; +} +.footer-inner > div:not(:first-child) { + margin: 0.25rem 0; + font-size: 0.85rem; +} +.footer-inner .statistics { + display: flex; + flex-direction: row; + justify-content: center; +} +.footer-inner .statistics > span { + flex: 1; + margin: 0 0.25rem; +} +.footer-inner .statistics > *:nth-last-child(2):first-child { + text-align: right; +} +.footer-inner .statistics > *:nth-last-child(2):first-child ~ * { + text-align: left; +} +.footer-inner .beian { + display: flex; + flex-direction: row; + justify-content: center; +} +.footer-inner .beian > * { + margin: 0 0.25rem; +} +.footer-inner .beian-police { + position: relative; + overflow: hidden; + display: inline-flex; + align-items: center; + justify-content: left; +} +.footer-inner .beian-police img { + margin-right: 3px; + width: 1rem; + height: 1rem; + margin-bottom: 0.1rem; +} +@media (max-width: 424px) { + .footer-inner .statistics { + flex-direction: column; + } + .footer-inner .statistics > *:nth-last-child(2):first-child { + text-align: center; + } + .footer-inner .statistics > *:nth-last-child(2):first-child ~ * { + text-align: center; + } + .footer-inner .beian { + flex-direction: column; + } + .footer-inner .beian .beian-police { + justify-content: center; + } + .footer-inner .beian > *:nth-last-child(2):first-child { + text-align: center; + } + .footer-inner .beian > *:nth-last-child(2):first-child ~ * { + text-align: center; + } +} +sup > a::before, +.footnote-text::before { + display: block; + content: ""; + margin-top: -5rem; + height: 5rem; + width: 1px; + visibility: hidden; +} +sup > a::before, +.footnote-text::before { + display: inline-block; +} +.footnote-item::before { + display: block; + content: ""; + margin-top: -5rem; + height: 5rem; + width: 1px; + visibility: hidden; +} +.footnote-list ol { + list-style-type: none; + counter-reset: sectioncounter; + padding-left: 0.5rem; + font-size: 0.95rem; +} +.footnote-list ol li:before { + font-family: "Helvetica Neue", monospace, "Monaco"; + content: "[" counter(sectioncounter) "]"; + counter-increment: sectioncounter; +} +.footnote-list ol li+li { + margin-top: 0.5rem; +} +.footnote-text { + padding-left: 0.5em; +} +.navbar { + background-color: transparent; + font-size: 0.875rem; + box-shadow: 0 2px 5px 0 rgba(0,0,0,0.16), 0 2px 10px 0 rgba(0,0,0,0.12); + -webkit-box-shadow: 0 2px 5px 0 rgba(0,0,0,0.16), 0 2px 10px 0 rgba(0,0,0,0.12); +} +.navbar .navbar-brand { + color: var(--navbar-text-color); +} +.navbar .navbar-toggler .animated-icon span { + background-color: var(--navbar-text-color); +} +.navbar .nav-item .nav-link { + display: block; + color: var(--navbar-text-color); + transition: color 0.2s ease-in-out, background-color 0.2s ease-in-out; +} +.navbar .nav-item .nav-link:hover { + color: var(--link-hover-color); +} +.navbar .nav-item .nav-link:focus { + color: var(--navbar-text-color); +} +.navbar .nav-item .nav-link i { + font-size: 0.875rem; + line-height: inherit; +} +.navbar .nav-item .nav-link i:only-child { + margin: 0 0.2rem; +} +.navbar .navbar-toggler { + border-width: 0; + outline: 0; +} +.navbar.scrolling-navbar { + will-change: background, padding; + -webkit-transition: background 0.5s ease-in-out, padding 0.5s ease-in-out; + transition: background 0.5s ease-in-out, padding 0.5s ease-in-out; +} +@media (min-width: 600px) { + .navbar.scrolling-navbar { + padding-top: 12px; + padding-bottom: 12px; + } + .navbar.scrolling-navbar .navbar-nav > li { + -webkit-transition-duration: 1s; + transition-duration: 1s; + } +} +.navbar.scrolling-navbar.top-nav-collapse { + padding-top: 5px; + padding-bottom: 5px; +} +.navbar .dropdown-menu { + font-size: 0.875rem; + color: var(--navbar-text-color); + background-color: rgba(0,0,0,0.3); + border: none; + min-width: 8rem; + -webkit-transition: background 0.5s ease-in-out, padding 0.5s ease-in-out; + transition: background 0.5s ease-in-out, padding 0.5s ease-in-out; +} +@media (max-width: 991.98px) { + .navbar .dropdown-menu { + text-align: center; + } +} +.navbar .dropdown-item { + color: var(--navbar-text-color); +} +.navbar .dropdown-item:hover, +.navbar .dropdown-item:focus { + color: var(--link-hover-color); + background-color: rgba(0,0,0,0.1); +} +@media (min-width: 992px) { + .navbar .dropdown:hover > .dropdown-menu { + display: block; + } + .navbar .dropdown > .dropdown-toggle:active { + pointer-events: none; + } + .navbar .dropdown-menu { + top: 95%; + } +} +.navbar .animated-icon { + width: 30px; + height: 20px; + position: relative; + margin: 0; + -webkit-transform: rotate(0deg); + -moz-transform: rotate(0deg); + -o-transform: rotate(0deg); + transform: rotate(0deg); + -webkit-transition: 0.5s ease-in-out; + -moz-transition: 0.5s ease-in-out; + -o-transition: 0.5s ease-in-out; + transition: 0.5s ease-in-out; + cursor: pointer; +} +.navbar .animated-icon span { + display: block; + position: absolute; + height: 3px; + width: 100%; + border-radius: 9px; + opacity: 1; + left: 0; + -webkit-transform: rotate(0deg); + -moz-transform: rotate(0deg); + -o-transform: rotate(0deg); + transform: rotate(0deg); + -webkit-transition: 0.25s ease-in-out; + -moz-transition: 0.25s ease-in-out; + -o-transition: 0.25s ease-in-out; + transition: 0.25s ease-in-out; + background: #fff; +} +.navbar .animated-icon span:nth-child(1) { + top: 0; +} +.navbar .animated-icon span:nth-child(2) { + top: 10px; +} +.navbar .animated-icon span:nth-child(3) { + top: 20px; +} +.navbar .animated-icon.open span:nth-child(1) { + top: 11px; + -webkit-transform: rotate(135deg); + -moz-transform: rotate(135deg); + -o-transform: rotate(135deg); + transform: rotate(135deg); +} +.navbar .animated-icon.open span:nth-child(2) { + opacity: 0; + left: -60px; +} +.navbar .animated-icon.open span:nth-child(3) { + top: 11px; + -webkit-transform: rotate(-135deg); + -moz-transform: rotate(-135deg); + -o-transform: rotate(-135deg); + transform: rotate(-135deg); +} +.navbar .dropdown-collapse, +.top-nav-collapse, +.navbar-col-show { + background-color: var(--navbar-bg-color); +} +@media (max-width: 767px) { + .navbar { + font-size: 1rem; + line-height: 2.5rem; + } +} +.banner-text { + color: var(--subtitle-color); + max-width: calc(960px - 6rem); + width: 80%; + overflow-wrap: break-word; +} +.banner-text .typed-cursor { + margin: 0 0.2rem; +} +@media (max-width: 767px) { + #subtitle, + .typed-cursor { + font-size: 1.5rem; + } +} +@media (max-width: 575px) { + .banner-text { + font-size: 0.9rem; + } + #subtitle, + .typed-cursor { + font-size: 1.35rem; + } +} +.modal-dialog .modal-content { + background-color: var(--board-bg-color); + border: 0; + border-radius: 0.125rem; + -webkit-box-shadow: 0 5px 11px 0 rgba(0,0,0,0.18), 0 4px 15px 0 rgba(0,0,0,0.15); + box-shadow: 0 5px 11px 0 rgba(0,0,0,0.18), 0 4px 15px 0 rgba(0,0,0,0.15); +} +.modal-dialog .modal-content .modal-header { + border-bottom-color: var(--line-color); + transition: border-bottom-color 0.2s ease-in-out; +} +.close { + color: var(--text-color); +} +.close:hover { + color: var(--link-hover-color); +} +.close:focus { + outline: 0; +} +.modal-dialog .modal-content .modal-header { + border-top-left-radius: 0.125rem; + border-top-right-radius: 0.125rem; + border-bottom: 1px solid #dee2e6; +} +.md-form { + position: relative; + margin-top: 1.5rem; + margin-bottom: 1.5rem; +} +.md-form input[type] { + -webkit-box-sizing: content-box; + box-sizing: content-box; + background-color: transparent; + border: none; + border-bottom: 1px solid #ced4da; + border-radius: 0; + outline: none; + -webkit-box-shadow: none; + box-shadow: none; + transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-box-shadow 0.15s ease-in-out; +} +.md-form input[type]:focus:not([readonly]) { + border-bottom: 1px solid #4285f4; + -webkit-box-shadow: 0 1px 0 0 #4285f4; + box-shadow: 0 1px 0 0 #4285f4; +} +.md-form input[type]:focus:not([readonly]) + label { + color: #4285f4; +} +.md-form input[type].valid, +.md-form input[type]:focus.valid { + border-bottom: 1px solid #00c851; + -webkit-box-shadow: 0 1px 0 0 #00c851; + box-shadow: 0 1px 0 0 #00c851; +} +.md-form input[type].valid + label, +.md-form input[type]:focus.valid + label { + color: #00c851; +} +.md-form input[type].invalid, +.md-form input[type]:focus.invalid { + border-bottom: 1px solid #f44336; + -webkit-box-shadow: 0 1px 0 0 #f44336; + box-shadow: 0 1px 0 0 #f44336; +} +.md-form input[type].invalid + label, +.md-form input[type]:focus.invalid + label { + color: #f44336; +} +.md-form input[type].validate { + margin-bottom: 2.5rem; +} +.md-form input[type].form-control { + height: auto; + padding: 0.6rem 0 0.4rem 0; + margin: 0 0 0.5rem 0; + color: var(--text-color); + background-color: transparent; + border-radius: 0; +} +.md-form label { + font-size: 0.8rem; + position: absolute; + top: -1rem; + left: 0; + color: #757575; + cursor: text; + transition: color 0.2s ease-out; +} +.modal-open[style] { + padding-right: 0 !important; + overflow: auto; +} +.modal-open[style] #navbar[style] { + padding-right: 1rem !important; +} +#nprogress .bar { + height: 3px !important; + background-color: #29d !important; +} +#nprogress .peg { + box-shadow: 0 0 14px #29d, 0 0 8px #29d !important; +} +@media (max-width: 575px) { + #nprogress .bar { + display: none; + } +} +.noscript-warning { + background-color: #f55; + color: #fff; + font-family: sans-serif; + font-size: 1rem; + font-weight: bold; + position: fixed; + left: 0; + bottom: 0; + text-align: center; + width: 100%; + z-index: 99; +} +.pagination { + margin-top: 3rem; + justify-content: center; +} +.pagination .space { + align-self: flex-end; +} +.pagination .page-number, +.pagination .current, +.pagination .extend { + outline: 0; + border: 0; + background-color: transparent; + font-size: 0.9rem; + padding: 0.5rem 0.75rem; + line-height: 1.25; + border-radius: 0.125rem; +} +.pagination .page-number { + margin: 0 0.05rem; +} +.pagination .page-number:hover, +.pagination .current { + transition: background-color 0.2s ease-in-out; + background-color: var(--link-hover-bg-color); +} +.qr-trigger { + cursor: pointer; + position: relative; +} +.qr-trigger:hover .qr-img { + display: block; + transition: all 0.3s; +} +.qr-img { + max-width: 12rem; + position: absolute; + right: -5.25rem; + z-index: 99; + display: none; + border-radius: 0.2rem; + background-color: transparent; + box-shadow: 0 0 20px -5px rgba(158,158,158,0.2); +} +.scroll-down-bar { + position: absolute; + width: 100%; + height: 6rem; + text-align: center; + cursor: pointer; + bottom: 0; +} +.scroll-down-bar i.iconfont { + font-size: 2rem; + font-weight: bold; + display: inline-block; + position: relative; + padding-top: 2rem; + color: var(--subtitle-color); + transform: translateZ(0); + animation: scroll-down 1.5s infinite; +} +#scroll-top-button { + position: fixed; + z-index: 99; + background: var(--board-bg-color); + transition: background-color 0.2s ease-in-out, bottom 0.3s ease; + border-radius: 4px; + min-width: 40px; + min-height: 40px; + bottom: -60px; + outline: none; + display: flex; + display: -webkit-flex; + align-items: center; + box-shadow: 0 2px 5px 0 rgba(0,0,0,0.16), 0 2px 10px 0 rgba(0,0,0,0.12); +} +#scroll-top-button i { + font-size: 32px; + margin: auto; + color: var(--sec-text-color); +} +#scroll-top-button:hover i, +#scroll-top-button:active i { + animation-name: scroll-top; + animation-duration: 1s; + animation-delay: 0.1s; + animation-timing-function: ease-in-out; + animation-iteration-count: infinite; + animation-fill-mode: forwards; + animation-direction: alternate; +} +#local-search-result .search-list-title { + border-left: 3px solid #0d47a1; +} +#local-search-result .search-list-content { + padding: 0 1.25rem; +} +#local-search-result .search-word { + color: #ff4500; +} +#toc { + visibility: hidden; +} +.toc-header { + margin-bottom: 0.5rem; + font-weight: bold; + line-height: 1.2; +} +.toc-header, +.toc-header > i { + font-size: 1.25rem; +} +.toc-body { + max-height: 75vh; + overflow-y: auto; + overflow: -moz-scrollbars-none; + -ms-overflow-style: none; +} +.toc-body ol { + list-style: none; + padding-inline-start: 1rem; +} +.toc-body::-webkit-scrollbar { + display: none; +} +.tocbot-list { + position: relative; +} +.tocbot-list ol { + list-style: none; + padding-left: 1rem; +} +.tocbot-list a { + font-size: 0.95rem; +} +.tocbot-link { + color: var(--text-color); +} +.tocbot-active-link { + font-weight: bold; + color: var(--link-hover-color); +} +.tocbot-is-collapsed { + max-height: 0; +} +.tocbot-is-collapsible { + overflow: hidden; + transition: all 0.3s ease-in-out; +} +.toc-list-item { + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} +.toc-list-item.is-active-li::before { + height: 1rem; + margin: 0.25rem 0; + visibility: visible; +} +.toc-list-item::before { + width: 0.15rem; + height: 0.2rem; + position: absolute; + left: 0.25rem; + content: ""; + border-radius: 2px; + margin: 0.65rem 0; + background: var(--link-hover-color); + visibility: hidden; + transition: height 0.1s ease-in-out, margin 0.1s ease-in-out, visibility 0.1s ease-in-out; +} +.sidebar { + position: -webkit-sticky; + position: sticky; + top: 2rem; + padding: 3rem 0; +} +html { + font-size: 16px; + letter-spacing: 0.02em; +} +html, +body { + height: 100%; + font-family: var(--font-family-sans-serif); + overflow-wrap: break-word; +} +body { + transition: color 0.2s ease-in-out, background-color 0.2s ease-in-out; + background-color: var(--body-bg-color); + color: var(--text-color); + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; +} +body a { + color: var(--text-color); + text-decoration: none; + cursor: pointer; + transition: color 0.2s ease-in-out, background-color 0.2s ease-in-out; +} +body a:hover { + color: var(--link-hover-color); + text-decoration: none; + transition: color 0.2s ease-in-out, background-color 0.2s ease-in-out; +} +code { + color: inherit; +} +table { + font-size: inherit; + color: var(--post-text-color); +} +img[lazyload] { + object-fit: cover; +} +*[align="left"] { + text-align: left; +} +*[align="center"] { + text-align: center; +} +*[align="right"] { + text-align: right; +} +::-webkit-scrollbar { + width: 6px; + height: 6px; +} +::-webkit-scrollbar-thumb { + background-color: var(--scrollbar-color); + border-radius: 6px; +} +::-webkit-scrollbar-thumb:hover { + background-color: var(--scrollbar-hover-color); +} +::-webkit-scrollbar-corner { + background-color: transparent; +} +label { + margin-bottom: 0; +} +i.iconfont { + font-size: 1em; + line-height: 1; +} +:root { + --color-mode: "light"; + --body-bg-color: #eee; + --board-bg-color: #fff; + --text-color: #3c4858; + --sec-text-color: #718096; + --post-text-color: #2c3e50; + --post-heading-color: #1a202c; + --post-link-color: #0366d6; + --link-hover-color: #30a9de; + --link-hover-bg-color: #f8f9fa; + --line-color: #eaecef; + --navbar-bg-color: #2f4154; + --navbar-text-color: #fff; + --subtitle-color: #fff; + --scrollbar-color: #c4c6c9; + --scrollbar-hover-color: #a6a6a6; + --button-bg-color: transparent; + --button-hover-bg-color: #f2f3f5; + --highlight-bg-color: #f6f8fa; + --inlinecode-bg-color: rgba(175,184,193,0.2); + --fold-title-color: #3c4858; + --fold-border-color: #eaecef; +} +@media (prefers-color-scheme: dark) { + :root { + --color-mode: "dark"; + } + :root:not([data-user-color-scheme]) { + --body-bg-color: #181c27; + --board-bg-color: #252d38; + --text-color: #c4c6c9; + --sec-text-color: #a7a9ad; + --post-text-color: #c4c6c9; + --post-heading-color: #c4c6c9; + --post-link-color: #1589e9; + --link-hover-color: #30a9de; + --link-hover-bg-color: #364151; + --line-color: #435266; + --navbar-bg-color: #1f3144; + --navbar-text-color: #d0d0d0; + --subtitle-color: #d0d0d0; + --scrollbar-color: #687582; + --scrollbar-hover-color: #9da8b3; + --button-bg-color: transparent; + --button-hover-bg-color: #46647e; + --highlight-bg-color: #303030; + --inlinecode-bg-color: rgba(99,110,123,0.4); + --fold-title-color: #c4c6c9; + --fold-border-color: #435266; + } + :root:not([data-user-color-scheme]) img { + -webkit-filter: brightness(0.9); + filter: brightness(0.9); + transition: filter 0.2s ease-in-out; + } + :root:not([data-user-color-scheme]) .license-box { + background-color: rgba(62,75,94,0.35); + transition: background-color 0.2s ease-in-out; + } + :root:not([data-user-color-scheme]) .gt-comment-admin .gt-comment-content { + background-color: transparent; + transition: background-color 0.2s ease-in-out; + } +} +@media not print { + [data-user-color-scheme="dark"] { + --body-bg-color: #181c27; + --board-bg-color: #252d38; + --text-color: #c4c6c9; + --sec-text-color: #a7a9ad; + --post-text-color: #c4c6c9; + --post-heading-color: #c4c6c9; + --post-link-color: #1589e9; + --link-hover-color: #30a9de; + --link-hover-bg-color: #364151; + --line-color: #435266; + --navbar-bg-color: #1f3144; + --navbar-text-color: #d0d0d0; + --subtitle-color: #d0d0d0; + --scrollbar-color: #687582; + --scrollbar-hover-color: #9da8b3; + --button-bg-color: transparent; + --button-hover-bg-color: #46647e; + --highlight-bg-color: #303030; + --inlinecode-bg-color: rgba(99,110,123,0.4); + --fold-title-color: #c4c6c9; + --fold-border-color: #435266; + } + [data-user-color-scheme="dark"] img { + -webkit-filter: brightness(0.9); + filter: brightness(0.9); + transition: filter 0.2s ease-in-out; + } + [data-user-color-scheme="dark"] .license-box { + background-color: rgba(62,75,94,0.35); + transition: background-color 0.2s ease-in-out; + } + [data-user-color-scheme="dark"] .gt-comment-admin .gt-comment-content { + background-color: transparent; + transition: background-color 0.2s ease-in-out; + } +} +@media print { + :root { + --color-mode: "light"; + } +} +.fade-in-up { + -webkit-animation-name: fade-in-up; + animation-name: fade-in-up; +} +.hidden-mobile { + display: block; +} +.visible-mobile { + display: none; +} +@media (max-width: 575px) { + .hidden-mobile { + display: none; + } + .visible-mobile { + display: block; + } +} +.nomargin-x { + margin-left: 0 !important; + margin-right: 0 !important; +} +.nopadding-x { + padding-left: 0 !important; + padding-right: 0 !important; +} +@media (max-width: 767px) { + .nopadding-x-md { + padding-left: 0 !important; + padding-right: 0 !important; + } +} +.flex-center { + display: -webkit-box; + display: -ms-flexbox; + display: flex; + -webkit-box-align: center; + -ms-flex-align: center; + align-items: center; + -webkit-box-pack: center; + -ms-flex-pack: center; + justify-content: center; + height: 100%; +} +.hover-with-bg { + display: inline-block; + line-height: 1; +} +.hover-with-bg:hover { + background-color: var(--link-hover-bg-color); + transition-duration: 0.2s; + transition-timing-function: ease-in-out; + border-radius: 0.2rem; +} +@-moz-keyframes fade-in-up { + from { + opacity: 0; + -webkit-transform: translate3d(0, 100%, 0); + transform: translate3d(0, 100%, 0); + } + to { + opacity: 1; + -webkit-transform: translate3d(0, 0, 0); + transform: translate3d(0, 0, 0); + } +} +@-webkit-keyframes fade-in-up { + from { + opacity: 0; + -webkit-transform: translate3d(0, 100%, 0); + transform: translate3d(0, 100%, 0); + } + to { + opacity: 1; + -webkit-transform: translate3d(0, 0, 0); + transform: translate3d(0, 0, 0); + } +} +@-o-keyframes fade-in-up { + from { + opacity: 0; + -webkit-transform: translate3d(0, 100%, 0); + transform: translate3d(0, 100%, 0); + } + to { + opacity: 1; + -webkit-transform: translate3d(0, 0, 0); + transform: translate3d(0, 0, 0); + } +} +@keyframes fade-in-up { + from { + opacity: 0; + -webkit-transform: translate3d(0, 100%, 0); + transform: translate3d(0, 100%, 0); + } + to { + opacity: 1; + -webkit-transform: translate3d(0, 0, 0); + transform: translate3d(0, 0, 0); + } +} +@-moz-keyframes scroll-down { + 0% { + opacity: 0.8; + top: 0; + } + 50% { + opacity: 0.4; + top: -1em; + } + 100% { + opacity: 0.8; + top: 0; + } +} +@-webkit-keyframes scroll-down { + 0% { + opacity: 0.8; + top: 0; + } + 50% { + opacity: 0.4; + top: -1em; + } + 100% { + opacity: 0.8; + top: 0; + } +} +@-o-keyframes scroll-down { + 0% { + opacity: 0.8; + top: 0; + } + 50% { + opacity: 0.4; + top: -1em; + } + 100% { + opacity: 0.8; + top: 0; + } +} +@keyframes scroll-down { + 0% { + opacity: 0.8; + top: 0; + } + 50% { + opacity: 0.4; + top: -1em; + } + 100% { + opacity: 0.8; + top: 0; + } +} +@-moz-keyframes scroll-top { + 0% { + -webkit-transform: translateY(0); + transform: translateY(0); + } + 50% { + -webkit-transform: translateY(-0.35rem); + transform: translateY(-0.35rem); + } + 100% { + -webkit-transform: translateY(0); + transform: translateY(0); + } +} +@-webkit-keyframes scroll-top { + 0% { + -webkit-transform: translateY(0); + transform: translateY(0); + } + 50% { + -webkit-transform: translateY(-0.35rem); + transform: translateY(-0.35rem); + } + 100% { + -webkit-transform: translateY(0); + transform: translateY(0); + } +} +@-o-keyframes scroll-top { + 0% { + -webkit-transform: translateY(0); + transform: translateY(0); + } + 50% { + -webkit-transform: translateY(-0.35rem); + transform: translateY(-0.35rem); + } + 100% { + -webkit-transform: translateY(0); + transform: translateY(0); + } +} +@keyframes scroll-top { + 0% { + -webkit-transform: translateY(0); + transform: translateY(0); + } + 50% { + -webkit-transform: translateY(-0.35rem); + transform: translateY(-0.35rem); + } + 100% { + -webkit-transform: translateY(0); + transform: translateY(0); + } +} +@media print { + header, + footer, + .side-col, + #scroll-top-button, + .post-prevnext, + #comments { + display: none !important; + } + .markdown-body a:not([href^='#']):not([href^='javascript:']):not(.print-no-link)::after { + content: ' (' attr(href) ')'; + font-size: 0.8rem; + color: var(--post-text-color); + opacity: 0.8; + } + .markdown-body > h1, + .markdown-body h2 { + border-bottom-color: transparent !important; + } + .markdown-body > h1, + .markdown-body h2, + .markdown-body h3, + .markdown-body h4, + .markdown-body h5, + .markdown-body h6 { + margin-top: 1.25em !important; + margin-bottom: 0.25em !important; + } + .markdown-body [data-anchorjs-icon]::after { + display: none; + } + .markdown-body figure.highlight table, + .markdown-body figure.highlight tbody, + .markdown-body figure.highlight tr, + .markdown-body figure.highlight td.code, + .markdown-body figure.highlight td.code pre { + width: 100% !important; + display: block !important; + } + .markdown-body figure.highlight pre > code { + white-space: pre-wrap; + } + .markdown-body figure.highlight .gutter, + .markdown-body figure.highlight .code-widget { + display: none !important; + } + .post-metas a { + text-decoration: none; + } +} +@media not print { + #seo-header { + display: none; + } +} +.index-card { + margin-bottom: 2.5rem; +} +.index-img img { + display: block; + width: 100%; + height: 10rem; + object-fit: cover; + box-shadow: 0 5px 11px 0 rgba(0,0,0,0.18), 0 4px 15px 0 rgba(0,0,0,0.15); + border-radius: 0.25rem; + background-color: transparent; +} +.index-info { + display: flex; + flex-direction: column; + justify-content: space-between; + padding-top: 0.5rem; + padding-bottom: 0.5rem; +} +.index-header { + color: var(--text-color); + font-size: 1.5rem; + font-weight: bold; + line-height: 1.4; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + margin-bottom: 0.25rem; +} +.index-header .index-pin { + color: var(--text-color); + font-size: 1.5rem; + margin-right: 0.15rem; +} +.index-btm { + color: var(--sec-text-color); +} +.index-btm a { + color: var(--sec-text-color); +} +.index-excerpt { + color: var(--sec-text-color); + margin: 0.5rem 0; + height: calc(1.4rem * 3); + overflow: hidden; + display: flex; +} +.index-excerpt > div { + width: 100%; + line-height: 1.4rem; + word-break: break-word; + display: -webkit-box; + -webkit-box-orient: vertical; + -webkit-line-clamp: 3; +} +.index-excerpt__noimg { + height: auto; + max-height: calc(1.4rem * 3); +} +@media (max-width: 767px) { + .index-info { + padding-top: 1.25rem; + } + .index-header { + font-size: 1.25rem; + white-space: normal; + overflow: hidden; + word-break: break-word; + display: -webkit-box; + -webkit-box-orient: vertical; + -webkit-line-clamp: 2; + } + .index-header .index-pin { + font-size: 1.25rem; + } + .index-excerpt { + height: auto; + max-height: calc(1.4rem * 3); + margin: 0.25rem 0; + } +} +#valine.v[data-class=v] .status-bar, +#valine.v[data-class=v] .veditor, +#valine.v[data-class=v] .vinput, +#valine.v[data-class=v] .vbtn, +#valine.v[data-class=v] p, +#valine.v[data-class=v] pre code { + color: var(--text-color); +} +#valine.v[data-class=v] .vinput::placeholder { + color: var(--sec-text-color); +} +#valine.v[data-class=v] .vicon { + fill: var(--text-color); +} +.gt-container .gt-comment-content:hover { + -webkit-box-shadow: none; + box-shadow: none; +} +.gt-container .gt-comment-body { + color: var(--text-color) !important; + transition: color 0.2s ease-in-out; +} +#remark-km423lmfdslkm34-back { + z-index: 1030; +} +#remark-km423lmfdslkm34-node { + z-index: 1031; +} +.markdown-body .highlight pre, +.markdown-body pre { + padding: 1.45rem 1rem; +} +.markdown-body pre code.hljs { + padding: 0; +} +.markdown-body pre[class*="language-"] { + padding-top: 1.45rem; + padding-bottom: 1.45rem; + padding-right: 1rem; + line-height: 1.5; + margin-bottom: 1rem; +} +.markdown-body .code-wrapper { + position: relative; + border-radius: 4px; + margin-bottom: 1rem; +} +.markdown-body .hljs, +.markdown-body .highlight pre, +.markdown-body .code-wrapper pre, +.markdown-body figure.highlight td.gutter { + transition: color 0.2s ease-in-out, background-color 0.2s ease-in-out; + background-color: var(--highlight-bg-color); +} +pre[class*=language-].line-numbers { + position: initial; +} +figure { + margin: 1rem 0; +} +figure.highlight { + position: relative; +} +figure.highlight table { + border: 0; + margin: 0; + width: auto; + border-radius: 4px; +} +figure.highlight td { + border: 0; + padding: 0; +} +figure.highlight tr { + border: 0; +} +figure.highlight td.code { + width: 100%; +} +figure.highlight td.gutter { + display: table-cell; + position: -webkit-sticky; + position: sticky; + left: 0; + z-index: 1; +} +figure.highlight td.gutter pre { + text-align: right; + padding: 0 0.75rem; + border-radius: initial; + border-right: 1px solid #999; +} +figure.highlight td.gutter pre span.line { + color: #999; +} +figure.highlight td.code > pre { + border-top-left-radius: 0; + border-bottom-left-radius: 0; +} +.markdown-body { + font-size: 1rem; + line-height: 1.6; + font-family: var(--font-family-sans-serif); + margin-bottom: 2rem; + color: var(--post-text-color); +} +.markdown-body > h1, +.markdown-body h2 { + border-bottom-color: var(--line-color); +} +.markdown-body > h1, +.markdown-body h2, +.markdown-body h3, +.markdown-body h4, +.markdown-body h5, +.markdown-body h6 { + color: var(--post-heading-color); + transition: color 0.2s ease-in-out, border-bottom-color 0.2s ease-in-out; + font-weight: bold; + margin-bottom: 0.75em; + margin-top: 2em; +} +.markdown-body > h1::before, +.markdown-body h2::before, +.markdown-body h3::before, +.markdown-body h4::before, +.markdown-body h5::before, +.markdown-body h6::before { + display: block; + content: ""; + margin-top: -5rem; + height: 5rem; + width: 1px; + visibility: hidden; +} +.markdown-body > h1:focus, +.markdown-body h2:focus, +.markdown-body h3:focus, +.markdown-body h4:focus, +.markdown-body h5:focus, +.markdown-body h6:focus { + outline: none; +} +.markdown-body a { + color: var(--post-link-color); +} +.markdown-body strong { + font-weight: bold; +} +.markdown-body code { + tab-size: 4; + background-color: var(--inlinecode-bg-color); + transition: background-color 0.2s ease-in-out; +} +.markdown-body table tr { + background-color: var(--board-bg-color); + transition: background-color 0.2s ease-in-out; +} +.markdown-body table tr:nth-child(2n) { + background-color: var(--board-bg-color); + transition: background-color 0.2s ease-in-out; +} +.markdown-body table th, +.markdown-body table td { + border-color: var(--line-color); + transition: border-color 0.2s ease-in-out; +} +.markdown-body pre { + font-size: 85% !important; +} +.markdown-body pre .mermaid { + text-align: center; +} +.markdown-body pre .mermaid > svg { + min-width: 100%; +} +.markdown-body p > img, +.markdown-body p > a > img, +.markdown-body figure > img, +.markdown-body figure > a > img { + max-width: 90%; + margin: 1.5rem auto; + display: block; + box-shadow: 0 5px 11px 0 rgba(0,0,0,0.18), 0 4px 15px 0 rgba(0,0,0,0.15); + border-radius: 4px; + background-color: transparent; +} +.markdown-body blockquote { + color: var(--sec-text-color); +} +.markdown-body details { + cursor: pointer; +} +.markdown-body details summary { + outline: none; +} +hr, +.markdown-body hr { + background-color: initial; + border-top: 1px solid var(--line-color); + transition: border-top-color 0.2s ease-in-out; +} +.markdown-body hr { + height: 0; + margin: 2rem 0; +} +.markdown-body figcaption.image-caption { + font-size: 0.8rem; + color: var(--post-text-color); + opacity: 0.65; + line-height: 1; + margin: -0.75rem auto 2rem; + text-align: center; +} +.markdown-body figcaption:not(.image-caption) { + display: none; +} +.post-content, +post-custom { + box-sizing: border-box; + padding-left: 10%; + padding-right: 10%; +} +@media (max-width: 767px) { + .post-content, + post-custom { + padding-left: 2rem; + padding-right: 2rem; + } + .page-content, + .post-content { + overflow: hidden; + } +} +@media (max-width: 424px) { + .post-content, + post-custom { + padding-left: 1rem; + padding-right: 1rem; + } + .page-content, + .post-content { + overflow: hidden; + } + .anchorjs-link-left { + opacity: 0 !important; + } +} +.page-content strong, +.post-content strong { + font-weight: bold; +} +.page-content > *:nth-child(2), +.post-content > *:nth-child(2) { + margin-top: 0; +} +.page-content img, +.post-content img { + object-fit: cover; + max-width: 100%; +} +.post-metas { + display: flex; + flex-wrap: wrap; + font-size: 0.9rem; +} +.post-meta > *:not(.hover-with-bg) { + margin-right: 0.2rem; +} +.post-prevnext { + display: flex; + flex-wrap: wrap; + justify-content: space-between; + font-size: 0.9rem; + margin-left: -0.35rem; + margin-right: -0.35rem; +} +.post-prevnext .post-prev, +.post-prevnext .post-next { + display: flex; + padding-left: 0; + padding-right: 0; +} +.post-prevnext .post-prev i, +.post-prevnext .post-next i { + font-size: 1.5rem; +} +.post-prevnext .post-prev a, +.post-prevnext .post-next a { + display: flex; + align-items: center; +} +.post-prevnext .post-prev .hidden-mobile, +.post-prevnext .post-next .hidden-mobile { + display: -webkit-box; + -webkit-box-orient: vertical; + -webkit-line-clamp: 2; + text-overflow: ellipsis; + overflow: hidden; +} +@media (max-width: 575px) { + .post-prevnext .post-prev .hidden-mobile, + .post-prevnext .post-next .hidden-mobile { + display: none; + } +} +.post-prevnext .post-prev:hover i, +.post-prevnext .post-prev:active i, +.post-prevnext .post-next:hover i, +.post-prevnext .post-next:active i { + -webkit-animation-duration: 1s; + animation-duration: 1s; + -webkit-animation-delay: 0.1s; + animation-delay: 0.1s; + -webkit-animation-timing-function: ease-in-out; + animation-timing-function: ease-in-out; + -webkit-animation-iteration-count: infinite; + animation-iteration-count: infinite; + -webkit-animation-fill-mode: forwards; + animation-fill-mode: forwards; + -webkit-animation-direction: alternate; + animation-direction: alternate; +} +.post-prevnext .post-prev:hover i, +.post-prevnext .post-prev:active i { + -webkit-animation-name: post-prev-anim; + animation-name: post-prev-anim; +} +.post-prevnext .post-next:hover i, +.post-prevnext .post-next:active i { + -webkit-animation-name: post-next-anim; + animation-name: post-next-anim; +} +.post-prevnext .post-next { + justify-content: flex-end; +} +.post-prevnext .fa-chevron-left { + margin-right: 0.5rem; +} +.post-prevnext .fa-chevron-right { + margin-left: 0.5rem; +} +#seo-header { + color: var(--post-heading-color); + font-weight: bold; + margin-top: 0.5em; + margin-bottom: 0.75em; + border-bottom-color: var(--line-color); + border-bottom-style: solid; + border-bottom-width: 2px; + line-height: 1.5; +} +.custom, +#comments { + margin-top: 2rem; +} +#comments noscript { + display: block; + text-align: center; + padding: 2rem 0; +} +.visitors { + font-size: 0.8em; + padding: 0.45rem; + float: right; +} +a.fancybox:hover { + text-decoration: none; +} +mjx-container, +.mjx-container { + overflow-x: auto; + overflow-y: hidden !important; + padding: 0.5em 0; +} +mjx-container:focus, +.mjx-container:focus, +mjx-container svg:focus, +.mjx-container svg:focus { + outline: none; +} +.mjx-char { + line-height: 1; +} +.katex-block { + overflow-x: auto; +} +.katex, +.mjx-mrow { + white-space: pre-wrap !important; +} +.footnote-ref [class*=hint--][aria-label]:after { + max-width: 12rem; + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} +@-moz-keyframes post-prev-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(-0.35rem); + transform: translateX(-0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@-webkit-keyframes post-prev-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(-0.35rem); + transform: translateX(-0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@-o-keyframes post-prev-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(-0.35rem); + transform: translateX(-0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@keyframes post-prev-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(-0.35rem); + transform: translateX(-0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@-moz-keyframes post-next-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(0.35rem); + transform: translateX(0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@-webkit-keyframes post-next-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(0.35rem); + transform: translateX(0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@-o-keyframes post-next-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(0.35rem); + transform: translateX(0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +@keyframes post-next-anim { + 0% { + -webkit-transform: translateX(0); + transform: translateX(0); + } + 50% { + -webkit-transform: translateX(0.35rem); + transform: translateX(0.35rem); + } + 100% { + -webkit-transform: translateX(0); + transform: translateX(0); + } +} +.fold { + margin: 1rem 0; + border: 0.5px solid var(--fold-border-color); + position: relative; + clear: both; + border-radius: 0.125rem; +} +.fold .fold-title { + color: var(--fold-title-color); + padding: 0.5rem 0.75rem; + font-size: 0.9rem; + font-weight: bold; + border-radius: 0.125rem; +} +.fold .fold-title:not(.collapsed) > .fold-arrow { + transform: rotate(90deg); + transform-origin: center center; +} +.fold .fold-title .fold-arrow { + display: inline-block; + margin-right: 0.35rem; + transition: transform 0.3s ease-out; +} +.fold .fold-content { + padding: 1rem 1rem; +} +.fold .fold-content > *:last-child { + margin-bottom: 0; +} +.fold-default, +.fold-secondary { + background-color: rgba(187,187,187,0.25); +} +.fold-primary { + background-color: rgba(183,160,224,0.25); +} +.fold-info { + background-color: rgba(160,197,228,0.25); +} +.fold-success { + background-color: rgba(174,220,174,0.25); +} +.fold-warning { + background-color: rgba(248,214,166,0.25); +} +.fold-danger { + background-color: rgba(236,169,167,0.25); +} +.fold-light { + background-color: rgba(254,254,254,0.25); +} +.note { + padding: 0.75rem; + border-left: 0.35rem solid; + border-radius: 0.25rem; + margin: 1.5rem 0; + color: var(--text-color); + transition: color 0.2s ease-in-out; + font-size: 0.9rem; +} +.note a { + color: var(--text-color); + transition: color 0.2s ease-in-out; +} +.note *:last-child { + margin-bottom: 0; +} +.note-default, +.note-secondary { + background-color: rgba(187,187,187,0.25); + border-color: #777; +} +.note-primary { + background-color: rgba(183,160,224,0.25); + border-color: #6f42c1; +} +.note-success { + background-color: rgba(174,220,174,0.25); + border-color: #5cb85c; +} +.note-danger { + background-color: rgba(236,169,167,0.25); + border-color: #d9534f; +} +.note-warning { + background-color: rgba(248,214,166,0.25); + border-color: #f0ad4e; +} +.note-info { + background-color: rgba(160,197,228,0.25); + border-color: #428bca; +} +.note-light { + background-color: rgba(254,254,254,0.25); + border-color: #0f0f0f; +} +.label { + display: inline; + border-radius: 3px; + font-size: 85%; + margin: 0; + padding: 0.2em 0.4em; + color: var(--text-color); + transition: color 0.2s ease-in-out; +} +.label-default, +.label-secondary { + background-color: rgba(187,187,187,0.25); +} +.label-primary { + background-color: rgba(183,160,224,0.25); +} +.label-info { + background-color: rgba(160,197,228,0.25); +} +.label-success { + background-color: rgba(174,220,174,0.25); +} +.label-warning { + background-color: rgba(248,214,166,0.25); +} +.label-danger { + background-color: rgba(236,169,167,0.25); +} +.markdown-body .btn { + border: 1px solid var(--line-color); + background-color: var(--button-bg-color); + color: var(--text-color); + transition: color 0.2s ease-in-out, background 0.2s ease-in-out, border-color 0.2s ease-in-out; + border-radius: 0.25rem; + display: inline-block; + font-size: 0.875em; + line-height: 2; + padding: 0 0.75rem; + margin-bottom: 1rem; +} +.markdown-body .btn:hover { + background-color: var(--button-hover-bg-color); + text-decoration: none; +} +.group-image-container { + margin: 1.5rem auto; +} +.group-image-container img { + margin: 0 auto; + border-radius: 3px; + background-color: transparent; + box-shadow: 0 3px 9px 0 rgba(0,0,0,0.15), 0 3px 9px 0 rgba(0,0,0,0.15); +} +.group-image-row { + margin-bottom: 0.5rem; + display: flex; + justify-content: center; +} +.group-image-wrap { + flex: 1; + display: flex; + justify-content: center; +} +.group-image-wrap:not(:last-child) { + margin-right: 0.25rem; +} +input[type=checkbox] { + margin: 0 0.2em 0.2em 0; + vertical-align: middle; +} +.list-group a ~ p.h5 { + margin-top: 1rem; +} +.list-group-item { + display: flex; + background-color: transparent; + border: 0; +} +.list-group-item time { + flex: 0 0 5rem; +} +.list-group-item .list-group-item-title { + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} +@media (max-width: 575px) { + .list-group-item { + font-size: 0.95rem; + padding: 0.5rem 0.75rem; + } + .list-group-item time { + flex: 0 0 4rem; + } +} +.list-group-item-action { + color: var(--text-color); +} +.list-group-item-action:focus, +.list-group-item-action:hover { + color: var(--link-hover-color); + background-color: var(--link-hover-bg-color); +} +.about-avatar { + position: relative; + margin: -8rem auto 1rem; + width: 10rem; + height: 10rem; + z-index: 3; +} +.about-avatar img { + width: 100%; + height: 100%; + border-radius: 50%; + background-color: transparent; + object-fit: cover; + box-shadow: 0 2px 5px 0 rgba(0,0,0,0.16), 0 2px 10px 0 rgba(0,0,0,0.12); +} +.about-info > div { + margin-bottom: 0.5rem; +} +.about-name { + font-size: 1.75rem; + font-weight: bold; +} +.about-intro { + font-size: 1rem; +} +.about-icons > a:not(:last-child) { + margin-right: 0.5rem; +} +.about-icons > a > i { + font-size: 1.5rem; +} +.category-bar .category-list { + max-height: 85vh; + overflow-y: auto; + overflow-x: hidden; +} +.category-bar .category-list::-webkit-scrollbar { + display: none; +} +.category-bar .category-list > .category-sub > a { + font-weight: bold; + font-size: 1.2rem; +} +.category-bar .category-list .category-item-action i { + margin: 0; +} +.category-bar .category-list .category-subitem.list-group-item { + padding-left: 0.5rem; + padding-right: 0; +} +.category-bar .category-list .category-collapse .category-post-list { + margin-top: 0.25rem; + margin-bottom: 0.5rem; +} +.category-bar .category-list .category-collapse .category-post { + font-size: 0.9rem; + line-height: 1.75; +} +.category-bar .category-list .category-item-action:hover { + background-color: initial; +} +.category-bar .list-group-item { + padding: 0; +} +.category-bar .list-group-item.active { + color: var(--link-hover-color); + background-color: initial; + font-weight: bold; + font-family: "iconfont"; + font-style: normal; + -webkit-font-smoothing: antialiased; +} +.category-bar .list-group-item.active::before { + content: "\e61f"; + font-weight: initial; + margin-right: 0.25rem; +} +.category-bar .list-group-count { + margin-left: 0.2rem; + margin-right: 0.2rem; + font-size: 0.9em; +} +.category-bar .list-group-item-action:focus, +.category-bar .list-group-item-action:hover { + background-color: initial; +} +.category-chains { + display: flex; + flex-wrap: wrap; +} +.category-chains > *:not(:last-child) { + margin-right: 1em; +} +.category:not(:last-child) { + margin-bottom: 1rem; +} +.category .category-item, +.category .category-subitem { + font-weight: bold; + display: flex; + align-items: center; +} +.category .category-item { + font-size: 1.25rem; +} +.category .category-subitem { + font-size: 1.1rem; +} +.category .category-collapse { + padding-left: 1.25rem; + width: 100%; +} +.category .category-count { + font-size: 0.9rem; + font-weight: initial; + min-width: 1.3em; + line-height: 1.3em; + display: flex; + align-items: center; +} +.category .category-count i { + padding-right: 0.25rem; +} +.category .category-count span { + width: 2rem; +} +.category .category-post { + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} +.category .category-item-action:not(.collapsed) > i { + transform: rotate(90deg); + transform-origin: center center; +} +.category .category-item-action i { + transition: transform 0.3s ease-out; + display: inline-block; + margin-left: 0.25rem; +} +.category .category-item-action .category:hover { + z-index: 1; + color: var(--link-hover-color); + text-decoration: none; + background-color: var(--link-hover-bg-color); +} +.category .row { + margin-left: 0; + margin-right: 0; +} +.tagcloud { + padding: 1rem 5%; +} +.tagcloud a { + display: inline-block; + padding: 0.5rem; +} +.tagcloud a:hover { + color: var(--link-hover-color) !important; +} +.links .card { + box-shadow: none; + min-width: 33%; + background-color: transparent; + border: 0; +} +.links .card-body { + margin: 1rem 0; + padding: 1rem; + border-radius: 0.3rem; + display: block; + width: 100%; + height: 100%; +} +.links .card-body:hover .link-avatar { + transform: scale(1.1); +} +.links .card-content { + display: flex; + flex-wrap: nowrap; + width: 100%; + height: 3.5rem; +} +.link-avatar { + flex: none; + width: 3rem; + height: 3rem; + margin-right: 0.75rem; + object-fit: cover; + transition-duration: 0.2s; + transition-timing-function: ease-in-out; +} +.link-avatar img { + width: 100%; + height: 100%; + border-radius: 50%; + background-color: transparent; + object-fit: cover; +} +.link-text { + flex: 1; + display: grid; + flex-direction: column; + line-height: 1.5; +} +.link-title { + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + color: var(--text-color); + font-weight: bold; +} +.link-intro { + max-height: 2rem; + font-size: 0.85rem; + line-height: 1.2; + color: var(--sec-text-color); + display: -webkit-box; + -webkit-box-orient: vertical; + -webkit-line-clamp: 2; + text-overflow: ellipsis; + overflow: hidden; +} +@media (max-width: 767px) { + .links { + display: flex; + flex-direction: column; + justify-content: center; + align-items: center; + } + .links .card { + padding-left: 2rem; + padding-right: 2rem; + } +} +@media (min-width: 768px) { + .link-text:only-child { + margin-left: 1rem; + } +} diff --git a/images/about/see-history.jpg b/images/about/see-history.jpg new file mode 100644 index 00000000..8cb3a9f4 Binary files /dev/null and b/images/about/see-history.jpg differ diff --git a/images/others/mac_xcode14.png b/images/others/mac_xcode14.png new file mode 100644 index 00000000..e12cfc93 Binary files /dev/null and b/images/others/mac_xcode14.png differ diff --git a/images/others/ntfs_for_mac_1.png b/images/others/ntfs_for_mac_1.png new file mode 100644 index 00000000..91e29bcf Binary files /dev/null and b/images/others/ntfs_for_mac_1.png differ diff --git a/images/others/ntfs_for_mac_2.png b/images/others/ntfs_for_mac_2.png new file mode 100644 index 00000000..24ab855c Binary files /dev/null and b/images/others/ntfs_for_mac_2.png differ diff --git a/images/others/ntfs_for_mac_3.png b/images/others/ntfs_for_mac_3.png new file mode 100644 index 00000000..24eb8887 Binary files /dev/null and b/images/others/ntfs_for_mac_3.png differ diff --git a/images/others/ntfs_for_mac_4.png b/images/others/ntfs_for_mac_4.png new file mode 100644 index 00000000..412c76c2 Binary files /dev/null and b/images/others/ntfs_for_mac_4.png differ diff --git a/images/others/ntfs_for_mac_5.png b/images/others/ntfs_for_mac_5.png new file mode 100644 index 00000000..7029d2c2 Binary files /dev/null and b/images/others/ntfs_for_mac_5.png differ diff --git a/images/others/ntfs_for_mac_6.png b/images/others/ntfs_for_mac_6.png new file mode 100644 index 00000000..5fefd775 Binary files /dev/null and b/images/others/ntfs_for_mac_6.png differ diff --git a/images/popularize/smellybaby.png b/images/popularize/smellybaby.png new file mode 100644 index 00000000..e333151d Binary files /dev/null and b/images/popularize/smellybaby.png differ diff --git a/images/site/avatar.png b/images/site/avatar.png new file mode 100644 index 00000000..ffd1c779 Binary files /dev/null and b/images/site/avatar.png differ diff --git a/images/site/baidu-site-search.jpg b/images/site/baidu-site-search.jpg new file mode 100644 index 00000000..44163348 Binary files /dev/null and b/images/site/baidu-site-search.jpg differ diff --git a/images/site/baidu-ziyuan-config.jpg b/images/site/baidu-ziyuan-config.jpg new file mode 100644 index 00000000..eb69f16a Binary files /dev/null and b/images/site/baidu-ziyuan-config.jpg differ diff --git a/images/site/baidu-ziyuan-fetch-test.jpg b/images/site/baidu-ziyuan-fetch-test.jpg new file mode 100644 index 00000000..20e5f8d9 Binary files /dev/null and b/images/site/baidu-ziyuan-fetch-test.jpg differ diff --git a/images/site/comment/beaudar-app-install.png b/images/site/comment/beaudar-app-install.png new file mode 100644 index 00000000..d21d0fae Binary files /dev/null and b/images/site/comment/beaudar-app-install.png differ diff --git a/images/site/comment/beaudar-error.png b/images/site/comment/beaudar-error.png new file mode 100644 index 00000000..13cb92ac Binary files /dev/null and b/images/site/comment/beaudar-error.png differ diff --git a/images/site/comment/beaudar_in_fluid.png b/images/site/comment/beaudar_in_fluid.png new file mode 100644 index 00000000..9a51a488 Binary files /dev/null and b/images/site/comment/beaudar_in_fluid.png differ diff --git a/images/site/comment/changyan_appid.png b/images/site/comment/changyan_appid.png new file mode 100644 index 00000000..dff14e8b Binary files /dev/null and b/images/site/comment/changyan_appid.png differ diff --git a/images/site/comment/changyan_show.png b/images/site/comment/changyan_show.png new file mode 100644 index 00000000..c0cdccc7 Binary files /dev/null and b/images/site/comment/changyan_show.png differ diff --git a/images/site/comment/giscus_config.png b/images/site/comment/giscus_config.png new file mode 100644 index 00000000..711af414 Binary files /dev/null and b/images/site/comment/giscus_config.png differ diff --git a/images/site/comment/giscus_config_show.png b/images/site/comment/giscus_config_show.png new file mode 100644 index 00000000..51251c65 Binary files /dev/null and b/images/site/comment/giscus_config_show.png differ diff --git a/images/site/comment/giscus_show.png b/images/site/comment/giscus_show.png new file mode 100644 index 00000000..194bb7eb Binary files /dev/null and b/images/site/comment/giscus_show.png differ diff --git a/images/site/comment/gitalk_init_show.png b/images/site/comment/gitalk_init_show.png new file mode 100644 index 00000000..423d363b Binary files /dev/null and b/images/site/comment/gitalk_init_show.png differ diff --git a/images/site/comment/github_discussions.png b/images/site/comment/github_discussions.png new file mode 100644 index 00000000..22ab646d Binary files /dev/null and b/images/site/comment/github_discussions.png differ diff --git a/images/site/comment/github_oauth_app_gen_client_secret.png b/images/site/comment/github_oauth_app_gen_client_secret.png new file mode 100644 index 00000000..9eab6aed Binary files /dev/null and b/images/site/comment/github_oauth_app_gen_client_secret.png differ diff --git a/images/site/comment/github_oauth_app_register.png b/images/site/comment/github_oauth_app_register.png new file mode 100644 index 00000000..46312244 Binary files /dev/null and b/images/site/comment/github_oauth_app_register.png differ diff --git a/images/site/comment/livere_city_install.png b/images/site/comment/livere_city_install.png new file mode 100644 index 00000000..c022d461 Binary files /dev/null and b/images/site/comment/livere_city_install.png differ diff --git a/images/site/comment/livere_script.png b/images/site/comment/livere_script.png new file mode 100644 index 00000000..b286277d Binary files /dev/null and b/images/site/comment/livere_script.png differ diff --git a/images/site/comment/livere_show.png b/images/site/comment/livere_show.png new file mode 100644 index 00000000..a8521f2d Binary files /dev/null and b/images/site/comment/livere_show.png differ diff --git a/images/site/comment/livere_show_register.png b/images/site/comment/livere_show_register.png new file mode 100644 index 00000000..3433d52a Binary files /dev/null and b/images/site/comment/livere_show_register.png differ diff --git a/images/site/comment/livere_version_compare.png b/images/site/comment/livere_version_compare.png new file mode 100644 index 00000000..4adb957b Binary files /dev/null and b/images/site/comment/livere_version_compare.png differ diff --git a/images/site/comment/netlify_add_mongo_url.png b/images/site/comment/netlify_add_mongo_url.png new file mode 100644 index 00000000..c321ceb3 Binary files /dev/null and b/images/site/comment/netlify_add_mongo_url.png differ diff --git a/images/site/comment/netlify_home.png b/images/site/comment/netlify_home.png new file mode 100644 index 00000000..3a8d85ed Binary files /dev/null and b/images/site/comment/netlify_home.png differ diff --git a/images/site/comment/twikoo_netlify_show.png b/images/site/comment/twikoo_netlify_show.png new file mode 100644 index 00000000..a7c3ec28 Binary files /dev/null and b/images/site/comment/twikoo_netlify_show.png differ diff --git a/images/site/comment/twioo_install_choose.png b/images/site/comment/twioo_install_choose.png new file mode 100644 index 00000000..f53f4516 Binary files /dev/null and b/images/site/comment/twioo_install_choose.png differ diff --git a/images/site/comment/utterances_install.png b/images/site/comment/utterances_install.png new file mode 100644 index 00000000..cb212e07 Binary files /dev/null and b/images/site/comment/utterances_install.png differ diff --git a/images/site/comment/utterances_show.png b/images/site/comment/utterances_show.png new file mode 100644 index 00000000..e0e2dadf Binary files /dev/null and b/images/site/comment/utterances_show.png differ diff --git a/images/site/favicon.ico b/images/site/favicon.ico new file mode 100644 index 00000000..86ec2557 Binary files /dev/null and b/images/site/favicon.ico differ diff --git a/images/site/favicon.jpg b/images/site/favicon.jpg new file mode 100644 index 00000000..2fae8217 Binary files /dev/null and b/images/site/favicon.jpg differ diff --git a/images/site/girl.jpeg b/images/site/girl.jpeg new file mode 100644 index 00000000..c922a4e2 Binary files /dev/null and b/images/site/girl.jpeg differ diff --git a/images/site/github_person_token_1.png b/images/site/github_person_token_1.png new file mode 100644 index 00000000..b3d0ad8a Binary files /dev/null and b/images/site/github_person_token_1.png differ diff --git a/images/site/github_person_token_2.png b/images/site/github_person_token_2.png new file mode 100644 index 00000000..945f0bfd Binary files /dev/null and b/images/site/github_person_token_2.png differ diff --git a/images/site/github_person_token_3.png b/images/site/github_person_token_3.png new file mode 100644 index 00000000..6ed9928f Binary files /dev/null and b/images/site/github_person_token_3.png differ diff --git a/images/site/github_person_token_4.png b/images/site/github_person_token_4.png new file mode 100644 index 00000000..61513232 Binary files /dev/null and b/images/site/github_person_token_4.png differ diff --git a/images/site/github_person_token_5.png b/images/site/github_person_token_5.png new file mode 100644 index 00000000..e8dc4b82 Binary files /dev/null and b/images/site/github_person_token_5.png differ diff --git a/images/site/hexo_fluid_init.png b/images/site/hexo_fluid_init.png new file mode 100644 index 00000000..a13c3404 Binary files /dev/null and b/images/site/hexo_fluid_init.png differ diff --git a/images/site/hexo_raw_init.png b/images/site/hexo_raw_init.png new file mode 100644 index 00000000..01a7eb73 Binary files /dev/null and b/images/site/hexo_raw_init.png differ diff --git a/images/site/night.jpg b/images/site/night.jpg new file mode 100644 index 00000000..1462d4f7 Binary files /dev/null and b/images/site/night.jpg differ diff --git a/images/site/private_repo_flow.png b/images/site/private_repo_flow.png new file mode 100644 index 00000000..242b7f36 Binary files /dev/null and b/images/site/private_repo_flow.png differ diff --git a/images/site/private_repo_new_action.png b/images/site/private_repo_new_action.png new file mode 100644 index 00000000..c22bf78b Binary files /dev/null and b/images/site/private_repo_new_action.png differ diff --git a/images/site/vercel-domain.jpg b/images/site/vercel-domain.jpg new file mode 100644 index 00000000..fee8a004 Binary files /dev/null and b/images/site/vercel-domain.jpg differ diff --git a/images/site/vercel-import-github-project.jpg b/images/site/vercel-import-github-project.jpg new file mode 100644 index 00000000..dfb23a12 Binary files /dev/null and b/images/site/vercel-import-github-project.jpg differ diff --git a/images/site/vercel-project-view.jpg b/images/site/vercel-project-view.jpg new file mode 100644 index 00000000..dc150089 Binary files /dev/null and b/images/site/vercel-project-view.jpg differ diff --git a/images/stash/spring-tx-aop-flow.png b/images/stash/spring-tx-aop-flow.png new file mode 100644 index 00000000..ca602530 Binary files /dev/null and b/images/stash/spring-tx-aop-flow.png differ diff --git a/images/tech/algorithm/move-window.png b/images/tech/algorithm/move-window.png new file mode 100644 index 00000000..99d082a7 Binary files /dev/null and b/images/tech/algorithm/move-window.png differ diff --git a/images/tech/db/mysql-read-timeout.jpg b/images/tech/db/mysql-read-timeout.jpg new file mode 100644 index 00000000..df586332 Binary files /dev/null and b/images/tech/db/mysql-read-timeout.jpg differ diff --git a/images/tech/db/mysql_waiting_for_global_read_lock.jpg b/images/tech/db/mysql_waiting_for_global_read_lock.jpg new file mode 100644 index 00000000..c7a23f80 Binary files /dev/null and b/images/tech/db/mysql_waiting_for_global_read_lock.jpg differ diff --git a/images/tech/dubbo/dubbo-arch.png b/images/tech/dubbo/dubbo-arch.png new file mode 100644 index 00000000..a3fad0b8 Binary files /dev/null and b/images/tech/dubbo/dubbo-arch.png differ diff --git a/images/tech/es/es_size_query_malformed.png b/images/tech/es/es_size_query_malformed.png new file mode 100644 index 00000000..a84d8330 Binary files /dev/null and b/images/tech/es/es_size_query_malformed.png differ diff --git a/images/tech/harmony/HiLog-position.png b/images/tech/harmony/HiLog-position.png new file mode 100644 index 00000000..243355c4 Binary files /dev/null and b/images/tech/harmony/HiLog-position.png differ diff --git a/images/tech/harmony/harmony-logo-3.png b/images/tech/harmony/harmony-logo-3.png new file mode 100644 index 00000000..05ebe911 Binary files /dev/null and b/images/tech/harmony/harmony-logo-3.png differ diff --git a/images/tech/harmony/http_cleartextTraffic_disable.png b/images/tech/harmony/http_cleartextTraffic_disable.png new file mode 100644 index 00000000..7a859927 Binary files /dev/null and b/images/tech/harmony/http_cleartextTraffic_disable.png differ diff --git a/images/tech/java/java-Objects-methods.png b/images/tech/java/java-Objects-methods.png new file mode 100644 index 00000000..d5da0b97 Binary files /dev/null and b/images/tech/java/java-Objects-methods.png differ diff --git a/images/tech/java/java-bin-desc.png b/images/tech/java/java-bin-desc.png new file mode 100644 index 00000000..82f6afc0 Binary files /dev/null and b/images/tech/java/java-bin-desc.png differ diff --git a/images/tech/java/jdk20-new-feature.jpeg b/images/tech/java/jdk20-new-feature.jpeg new file mode 100644 index 00000000..7142ad2e Binary files /dev/null and b/images/tech/java/jdk20-new-feature.jpeg differ diff --git a/images/tech/net/nat-through.png b/images/tech/net/nat-through.png new file mode 100644 index 00000000..61c7b5fb Binary files /dev/null and b/images/tech/net/nat-through.png differ diff --git a/images/tech/nginx/brew-info-nginx-not-find.png b/images/tech/nginx/brew-info-nginx-not-find.png new file mode 100644 index 00000000..d6baeee7 Binary files /dev/null and b/images/tech/nginx/brew-info-nginx-not-find.png differ diff --git a/images/tech/nginx/brew-install-nginx-success.png b/images/tech/nginx/brew-install-nginx-success.png new file mode 100644 index 00000000..22ee4769 Binary files /dev/null and b/images/tech/nginx/brew-install-nginx-success.png differ diff --git a/images/tech/nginx/brew-search-nginx-find.png b/images/tech/nginx/brew-search-nginx-find.png new file mode 100644 index 00000000..a33e55dc Binary files /dev/null and b/images/tech/nginx/brew-search-nginx-find.png differ diff --git a/images/tech/nginx/brew-search-nginx-not-find.png b/images/tech/nginx/brew-search-nginx-not-find.png new file mode 100644 index 00000000..1d2c7013 Binary files /dev/null and b/images/tech/nginx/brew-search-nginx-not-find.png differ diff --git a/images/tech/nginx/nginx-http-success.png b/images/tech/nginx/nginx-http-success.png new file mode 100644 index 00000000..a324a862 Binary files /dev/null and b/images/tech/nginx/nginx-http-success.png differ diff --git a/images/tech/nginx/nginx-version.png b/images/tech/nginx/nginx-version.png new file mode 100644 index 00000000..ba746b70 Binary files /dev/null and b/images/tech/nginx/nginx-version.png differ diff --git a/images/tech/safe/safe-http-host-attack.png b/images/tech/safe/safe-http-host-attack.png new file mode 100644 index 00000000..62ce04e8 Binary files /dev/null and b/images/tech/safe/safe-http-host-attack.png differ diff --git a/images/tech/safe/safe_cros_attack.png b/images/tech/safe/safe_cros_attack.png new file mode 100644 index 00000000..e78faa2d Binary files /dev/null and b/images/tech/safe/safe_cros_attack.png differ diff --git a/images/tech/safe/swagger-switch2.png b/images/tech/safe/swagger-switch2.png new file mode 100644 index 00000000..d559fbbd Binary files /dev/null and b/images/tech/safe/swagger-switch2.png differ diff --git a/images/tech/spring/springdoc-from-springfox.jpg b/images/tech/spring/springdoc-from-springfox.jpg new file mode 100644 index 00000000..3b910fed Binary files /dev/null and b/images/tech/spring/springdoc-from-springfox.jpg differ diff --git a/images/tech/spring/springdoc-petstore-page.jpg b/images/tech/spring/springdoc-petstore-page.jpg new file mode 100644 index 00000000..e58bc2a2 Binary files /dev/null and b/images/tech/spring/springdoc-petstore-page.jpg differ diff --git a/images/tech/spring/springdoc-swagger-default.jpg b/images/tech/spring/springdoc-swagger-default.jpg new file mode 100644 index 00000000..27d9cf6c Binary files /dev/null and b/images/tech/spring/springdoc-swagger-default.jpg differ diff --git a/images/tech/spring/springdoc-swagger-openApi.jpg b/images/tech/spring/springdoc-swagger-openApi.jpg new file mode 100644 index 00000000..bb1bf36b Binary files /dev/null and b/images/tech/spring/springdoc-swagger-openApi.jpg differ diff --git a/images/tech/spring/springdoc-swagger-properties.jpg b/images/tech/spring/springdoc-swagger-properties.jpg new file mode 100644 index 00000000..0eedd0f0 Binary files /dev/null and b/images/tech/spring/springdoc-swagger-properties.jpg differ diff --git a/images/tech/spring/springdoc-v3-apidocs.jpg b/images/tech/spring/springdoc-v3-apidocs.jpg new file mode 100644 index 00000000..c86212cd Binary files /dev/null and b/images/tech/spring/springdoc-v3-apidocs.jpg differ diff --git a/images/tech/spring/springfox-stop-update.jpg b/images/tech/spring/springfox-stop-update.jpg new file mode 100644 index 00000000..9d1acad0 Binary files /dev/null and b/images/tech/spring/springfox-stop-update.jpg differ diff --git a/images/tech/windows/windows_openssh_step1.png b/images/tech/windows/windows_openssh_step1.png new file mode 100644 index 00000000..0d619336 Binary files /dev/null and b/images/tech/windows/windows_openssh_step1.png differ diff --git a/images/tech/windows/windows_openssh_step2.png b/images/tech/windows/windows_openssh_step2.png new file mode 100644 index 00000000..b3774308 Binary files /dev/null and b/images/tech/windows/windows_openssh_step2.png differ diff --git a/images/tech/windows/windows_openssh_step3.png b/images/tech/windows/windows_openssh_step3.png new file mode 100644 index 00000000..7394b7c3 Binary files /dev/null and b/images/tech/windows/windows_openssh_step3.png differ diff --git a/img/avatar.png b/img/avatar.png new file mode 100644 index 00000000..ffd1c779 Binary files /dev/null and b/img/avatar.png differ diff --git a/img/default.png b/img/default.png new file mode 100644 index 00000000..2bc2cd74 Binary files /dev/null and b/img/default.png differ diff --git a/img/fluid.png b/img/fluid.png new file mode 100644 index 00000000..368a58ac Binary files /dev/null and b/img/fluid.png differ diff --git a/img/loading.gif b/img/loading.gif new file mode 100644 index 00000000..c5126ed9 Binary files /dev/null and b/img/loading.gif differ diff --git a/img/police_beian.png b/img/police_beian.png new file mode 100644 index 00000000..60190da0 Binary files /dev/null and b/img/police_beian.png differ diff --git a/index.html b/index.html new file mode 100644 index 00000000..e2dedc38 --- /dev/null +++ b/index.html @@ -0,0 +1,1045 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + + +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ + + + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/js/boot.js b/js/boot.js new file mode 100644 index 00000000..26c3a1a3 --- /dev/null +++ b/js/boot.js @@ -0,0 +1,22 @@ +/* global Fluid */ + +Fluid.boot = {}; + +Fluid.boot.registerEvents = function() { + Fluid.events.billboard(); + Fluid.events.registerNavbarEvent(); + Fluid.events.registerParallaxEvent(); + Fluid.events.registerScrollDownArrowEvent(); + Fluid.events.registerScrollTopArrowEvent(); + Fluid.events.registerImageLoadedEvent(); +}; + +Fluid.boot.refresh = function() { + Fluid.plugins.fancyBox(); + Fluid.plugins.codeWidget(); + Fluid.events.refresh(); +}; + +document.addEventListener('DOMContentLoaded', function() { + Fluid.boot.registerEvents(); +}); diff --git a/js/color-schema.js b/js/color-schema.js new file mode 100644 index 00000000..1931a20b --- /dev/null +++ b/js/color-schema.js @@ -0,0 +1,286 @@ +/* global Fluid */ + +/** + * Modified from https://blog.skk.moe/post/hello-darkmode-my-old-friend/ + */ +(function(window, document) { + var rootElement = document.documentElement; + var colorSchemaStorageKey = 'Fluid_Color_Scheme'; + var colorSchemaMediaQueryKey = '--color-mode'; + var userColorSchemaAttributeName = 'data-user-color-scheme'; + var defaultColorSchemaAttributeName = 'data-default-color-scheme'; + var colorToggleButtonSelector = '#color-toggle-btn'; + var colorToggleIconSelector = '#color-toggle-icon'; + var iframeSelector = 'iframe'; + + function setLS(k, v) { + try { + localStorage.setItem(k, v); + } catch (e) {} + } + + function removeLS(k) { + try { + localStorage.removeItem(k); + } catch (e) {} + } + + function getLS(k) { + try { + return localStorage.getItem(k); + } catch (e) { + return null; + } + } + + function getSchemaFromHTML() { + var res = rootElement.getAttribute(defaultColorSchemaAttributeName); + if (typeof res === 'string') { + return res.replace(/["'\s]/g, ''); + } + return null; + } + + function getSchemaFromCSSMediaQuery() { + var res = getComputedStyle(rootElement).getPropertyValue( + colorSchemaMediaQueryKey + ); + if (typeof res === 'string') { + return res.replace(/["'\s]/g, ''); + } + return null; + } + + function resetSchemaAttributeAndLS() { + rootElement.setAttribute(userColorSchemaAttributeName, getDefaultColorSchema()); + removeLS(colorSchemaStorageKey); + } + + var validColorSchemaKeys = { + dark : true, + light: true + }; + + function getDefaultColorSchema() { + // 取默认字段的值 + var schema = getSchemaFromHTML(); + // 如果明确指定了 schema 则返回 + if (validColorSchemaKeys[schema]) { + return schema; + } + // 默认优先按 prefers-color-scheme + schema = getSchemaFromCSSMediaQuery(); + if (validColorSchemaKeys[schema]) { + return schema; + } + // 否则按本地时间是否大于 18 点或凌晨 0 ~ 6 点 + var hours = new Date().getHours(); + if (hours >= 18 || (hours >= 0 && hours <= 6)) { + return 'dark'; + } + return 'light'; + } + + function applyCustomColorSchemaSettings(schema) { + // 接受从「开关」处传来的模式，或者从 localStorage 读取，否则按默认设置值 + var current = schema || getLS(colorSchemaStorageKey) || getDefaultColorSchema(); + + if (current === getDefaultColorSchema()) { + // 当用户切换的显示模式和默认模式相同时，则恢复为自动模式 + resetSchemaAttributeAndLS(); + } else if (validColorSchemaKeys[current]) { + rootElement.setAttribute( + userColorSchemaAttributeName, + current + ); + } else { + // 特殊情况重置 + resetSchemaAttributeAndLS(); + return; + } + + // 根据当前模式设置图标 + setButtonIcon(current); + + // 设置代码高亮 + setHighlightCSS(current); + + // 设置其他应用 + setApplications(current); + } + + var invertColorSchemaObj = { + dark : 'light', + light: 'dark' + }; + + function getIconClass(scheme) { + return 'icon-' + scheme; + } + + function toggleCustomColorSchema() { + var currentSetting = getLS(colorSchemaStorageKey); + + if (validColorSchemaKeys[currentSetting]) { + // 从 localStorage 中读取模式，并取相反的模式 + currentSetting = invertColorSchemaObj[currentSetting]; + } else if (currentSetting === null) { + // 当 localStorage 中没有相关值，或者 localStorage 抛了 Error + // 先按照按钮的状态进行切换 + var iconElement = document.querySelector(colorToggleIconSelector); + if (iconElement) { + currentSetting = iconElement.getAttribute('data'); + } + if (!iconElement || !validColorSchemaKeys[currentSetting]) { + // 当 localStorage 中没有相关值，或者 localStorage 抛了 Error，则读取默认值并切换到相反的模式 + currentSetting = invertColorSchemaObj[getSchemaFromCSSMediaQuery()]; + } + } else { + return; + } + // 将相反的模式写入 localStorage + setLS(colorSchemaStorageKey, currentSetting); + + return currentSetting; + } + + function setButtonIcon(schema) { + if (validColorSchemaKeys[schema]) { + // 切换图标 + var icon = getIconClass('dark'); + if (schema) { + icon = getIconClass(schema); + } + var iconElement = document.querySelector(colorToggleIconSelector); + if (iconElement) { + iconElement.setAttribute( + 'class', + 'iconfont ' + icon + ); + iconElement.setAttribute( + 'data', + invertColorSchemaObj[schema] + ); + } else { + // 如果图标不存在则说明图标还没加载出来，等到页面全部加载再尝试切换 + Fluid.utils.waitElementLoaded(colorToggleIconSelector, function() { + var iconElement = document.querySelector(colorToggleIconSelector); + if (iconElement) { + iconElement.setAttribute( + 'class', + 'iconfont ' + icon + ); + iconElement.setAttribute( + 'data', + invertColorSchemaObj[schema] + ); + } + }); + } + if (document.documentElement.getAttribute('data-user-color-scheme')) { + var color = getComputedStyle(document.documentElement).getPropertyValue('--navbar-bg-color').trim() + document.querySelector('meta[name="theme-color"]').setAttribute('content', color) + } + } + } + + function setHighlightCSS(schema) { + // 启用对应的代码高亮的样式 + var lightCss = document.getElementById('highlight-css'); + var darkCss = document.getElementById('highlight-css-dark'); + if (schema === 'dark') { + if (darkCss) { + darkCss.removeAttribute('disabled'); + } + if (lightCss) { + lightCss.setAttribute('disabled', ''); + } + } else { + if (lightCss) { + lightCss.removeAttribute('disabled'); + } + if (darkCss) { + darkCss.setAttribute('disabled', ''); + } + } + + setTimeout(function() { + // 设置代码块组件样式 + document.querySelectorAll('.markdown-body pre').forEach((pre) => { + var cls = Fluid.utils.getBackgroundLightness(pre) >= 0 ? 'code-widget-light' : 'code-widget-dark'; + var widget = pre.querySelector('.code-widget-light, .code-widget-dark'); + if (widget) { + widget.classList.remove('code-widget-light', 'code-widget-dark'); + widget.classList.add(cls); + } + }); + }, 200); + } + + function setApplications(schema) { + // 设置 remark42 评论主题 + if (window.REMARK42) { + window.REMARK42.changeTheme(schema); + } + + // 设置 cusdis 评论主题 + if (window.CUSDIS) { + window.CUSDIS.setTheme(schema); + } + + // 设置 utterances 评论主题 + var utterances = document.querySelector('.utterances-frame'); + if (utterances) { + var utterancesTheme = schema === 'dark' ? window.UtterancesThemeDark : window.UtterancesThemeLight; + const message = { + type : 'set-theme', + theme: utterancesTheme + }; + utterances.contentWindow.postMessage(message, 'https://utteranc.es'); + } + + // 设置 giscus 评论主题 + var giscus = document.querySelector('iframe.giscus-frame'); + if (giscus) { + var giscusTheme = schema === 'dark' ? window.GiscusThemeDark : window.GiscusThemeLight; + const message = { + setConfig: { + theme: giscusTheme, + } + }; + // giscus.style.cssText += 'color-scheme: normal;'; + giscus.contentWindow.postMessage({ 'giscus': message }, 'https://giscus.app'); + } + } + + // 当页面加载时，将显示模式设置为 localStorage 中自定义的值（如果有的话） + applyCustomColorSchemaSettings(); + + Fluid.utils.waitElementLoaded(colorToggleIconSelector, function() { + applyCustomColorSchemaSettings(); + var button = document.querySelector(colorToggleButtonSelector); + if (button) { + // 当用户点击切换按钮时，获得新的显示模式、写入 localStorage、并在页面上生效 + button.addEventListener('click', function() { + applyCustomColorSchemaSettings(toggleCustomColorSchema()); + }); + var icon = document.querySelector(colorToggleIconSelector); + if (icon) { + // 光标悬停在按钮上时，切换图标 + button.addEventListener('mouseenter', function() { + var current = icon.getAttribute('data'); + icon.classList.replace(getIconClass(invertColorSchemaObj[current]), getIconClass(current)); + }); + button.addEventListener('mouseleave', function() { + var current = icon.getAttribute('data'); + icon.classList.replace(getIconClass(current), getIconClass(invertColorSchemaObj[current])); + }); + } + } + }); + + Fluid.utils.waitElementLoaded(iframeSelector, function() { + applyCustomColorSchemaSettings(); + }); + +})(window, document); diff --git a/js/duration.js b/js/duration.js new file mode 100644 index 00000000..6b5fb6e3 --- /dev/null +++ b/js/duration.js @@ -0,0 +1,32 @@ +/** 统计网站运行的时间 **/ +!(function() { + /** 计时起始时间，自行修改 **/ + var start = new Date("2022/08/18 00:00:00"); + + function update() { + var now = new Date(); + now.setTime(now.getTime()+250); + days = (now - start) / 1000 / 60 / 60 / 24; + dnum = Math.floor(days); + hours = (now - start) / 1000 / 60 / 60 - (24 * dnum); + hnum = Math.floor(hours); + if(String(hnum).length === 1 ){ + hnum = "0" + hnum; + } + minutes = (now - start) / 1000 /60 - (24 * 60 * dnum) - (60 * hnum); + mnum = Math.floor(minutes); + if(String(mnum).length === 1 ){ + mnum = "0" + mnum; + } + seconds = (now - start) / 1000 - (24 * 60 * 60 * dnum) - (60 * 60 * hnum) - (60 * mnum); + snum = Math.round(seconds); + if(String(snum).length === 1 ){ + snum = "0" + snum; + } + document.getElementById("timeDate").innerHTML = "本站已安全运行 "+dnum+" 天"; + document.getElementById("times").innerHTML = hnum + " 小时 " + mnum + " 分 " + snum + " 秒"; + } + + update(); + setInterval(update, 1000); +})(); diff --git a/js/events.js b/js/events.js new file mode 100644 index 00000000..55e255f6 --- /dev/null +++ b/js/events.js @@ -0,0 +1,184 @@ +/* global Fluid */ + +HTMLElement.prototype.wrap = function(wrapper) { + this.parentNode.insertBefore(wrapper, this); + this.parentNode.removeChild(this); + wrapper.appendChild(this); +}; + +Fluid.events = { + + registerNavbarEvent: function() { + var navbar = jQuery('#navbar'); + if (navbar.length === 0) { + return; + } + var submenu = jQuery('#navbar .dropdown-menu'); + if (navbar.offset().top > 0) { + navbar.removeClass('navbar-dark'); + submenu.removeClass('navbar-dark'); + } + Fluid.utils.listenScroll(function() { + navbar[navbar.offset().top > 50 ? 'addClass' : 'removeClass']('top-nav-collapse'); + submenu[navbar.offset().top > 50 ? 'addClass' : 'removeClass']('dropdown-collapse'); + if (navbar.offset().top > 0) { + navbar.removeClass('navbar-dark'); + submenu.removeClass('navbar-dark'); + } else { + navbar.addClass('navbar-dark'); + submenu.removeClass('navbar-dark'); + } + }); + jQuery('#navbar-toggler-btn').on('click', function() { + jQuery('.animated-icon').toggleClass('open'); + jQuery('#navbar').toggleClass('navbar-col-show'); + }); + }, + + registerParallaxEvent: function() { + var ph = jQuery('#banner[parallax="true"]'); + if (ph.length === 0) { + return; + } + var board = jQuery('#board'); + if (board.length === 0) { + return; + } + var parallax = function() { + var pxv = jQuery(window).scrollTop() / 5; + var offset = parseInt(board.css('margin-top'), 10); + var max = 96 + offset; + if (pxv > max) { + pxv = max; + } + ph.css({ + transform: 'translate3d(0,' + pxv + 'px,0)' + }); + var sideCol = jQuery('.side-col'); + if (sideCol) { + sideCol.css({ + 'padding-top': pxv + 'px' + }); + } + }; + Fluid.utils.listenScroll(parallax); + }, + + registerScrollDownArrowEvent: function() { + var scrollbar = jQuery('.scroll-down-bar'); + if (scrollbar.length === 0) { + return; + } + scrollbar.on('click', function() { + Fluid.utils.scrollToElement('#board', -jQuery('#navbar').height()); + }); + }, + + registerScrollTopArrowEvent: function() { + var topArrow = jQuery('#scroll-top-button'); + if (topArrow.length === 0) { + return; + } + var board = jQuery('#board'); + if (board.length === 0) { + return; + } + var posDisplay = false; + var scrollDisplay = false; + // Position + var setTopArrowPos = function() { + var boardRight = board[0].getClientRects()[0].right; + var bodyWidth = document.body.offsetWidth; + var right = bodyWidth - boardRight; + posDisplay = right >= 50; + topArrow.css({ + 'bottom': posDisplay && scrollDisplay ? '20px' : '-60px', + 'right' : right - 64 + 'px' + }); + }; + setTopArrowPos(); + jQuery(window).resize(setTopArrowPos); + // Display + var headerHeight = board.offset().top; + Fluid.utils.listenScroll(function() { + var scrollHeight = document.body.scrollTop + document.documentElement.scrollTop; + scrollDisplay = scrollHeight >= headerHeight; + topArrow.css({ + 'bottom': posDisplay && scrollDisplay ? '20px' : '-60px' + }); + }); + // Click + topArrow.on('click', function() { + jQuery('body,html').animate({ + scrollTop: 0, + easing : 'swing' + }); + }); + }, + + registerImageLoadedEvent: function() { + if (!('NProgress' in window)) { return; } + + var bg = document.getElementById('banner'); + if (bg) { + var src = bg.style.backgroundImage; + var url = src.match(/\((.*?)\)/)[1].replace(/(['"])/g, ''); + var img = new Image(); + img.onload = function() { + window.NProgress && window.NProgress.status !== null && window.NProgress.inc(0.2); + }; + img.src = url; + if (img.complete) { img.onload(); } + } + + var notLazyImages = jQuery('main img:not([lazyload])'); + var total = notLazyImages.length; + for (const img of notLazyImages) { + const old = img.onload; + img.onload = function() { + old && old(); + window.NProgress && window.NProgress.status !== null && window.NProgress.inc(0.5 / total); + }; + if (img.complete) { img.onload(); } + } + }, + + registerRefreshCallback: function(callback) { + if (!Array.isArray(Fluid.events._refreshCallbacks)) { + Fluid.events._refreshCallbacks = []; + } + Fluid.events._refreshCallbacks.push(callback); + }, + + refresh: function() { + if (Array.isArray(Fluid.events._refreshCallbacks)) { + for (var callback of Fluid.events._refreshCallbacks) { + if (callback instanceof Function) { + callback(); + } + } + } + }, + + billboard: function() { + if (!('console' in window)) { + return; + } + // eslint-disable-next-line no-console + console.log(` +------------------------------------------------- +| | +| ________ __ _ __ | +| |_ __ |[ | (_) | ] | +| | |_ \\_| | | __ _ __ .--.| | | +| | _| | |[ | | | [ |/ /'\`\\' | | +| _| |_ | | | \\_/ |, | || \\__/ | | +| |_____| [___]'.__.'_/[___]'.__.;__] | +| | +| Powered by Hexo x Fluid | +| https://github.com/fluid-dev/hexo-theme-fluid | +| | +------------------------------------------------- + `); + } +}; diff --git a/js/img-lazyload.js b/js/img-lazyload.js new file mode 100644 index 00000000..c0c8e4ef --- /dev/null +++ b/js/img-lazyload.js @@ -0,0 +1,10 @@ +/* global Fluid, CONFIG */ + +(function(window, document) { + for (const each of document.querySelectorAll('img[lazyload]')) { + Fluid.utils.waitElementVisible(each, function() { + each.removeAttribute('srcset'); + each.removeAttribute('lazyload'); + }, CONFIG.lazyload.offset_factor); + } +})(window, document); diff --git a/js/leancloud.js b/js/leancloud.js new file mode 100644 index 00000000..ab901cec --- /dev/null +++ b/js/leancloud.js @@ -0,0 +1,192 @@ +/* global CONFIG */ +// eslint-disable-next-line no-console + +(function(window, document) { + // 查询存储的记录 + function getRecord(Counter, target) { + return new Promise(function(resolve, reject) { + Counter('get', '/classes/Counter?where=' + encodeURIComponent(JSON.stringify({ target }))) + .then(resp => resp.json()) + .then(({ results, code, error }) => { + if (code === 401) { + throw error; + } + if (results && results.length > 0) { + var record = results[0]; + resolve(record); + } else { + Counter('post', '/classes/Counter', { target, time: 0 }) + .then(resp => resp.json()) + .then((record, error) => { + if (error) { + throw error; + } + resolve(record); + }).catch(error => { + console.error('Failed to create: ', error); + reject(error); + }); + } + }).catch((error) => { + console.error('LeanCloud Counter Error: ', error); + reject(error); + }); + }); + } + + // 发起自增请求 + function increment(Counter, incrArr) { + return new Promise(function(resolve, reject) { + Counter('post', '/batch', { + 'requests': incrArr + }).then((res) => { + res = res.json(); + if (res.error) { + throw res.error; + } + resolve(res); + }).catch((error) => { + console.error('Failed to save visitor count: ', error); + reject(error); + }); + }); + } + + // 构建自增请求体 + function buildIncrement(objectId) { + return { + 'method': 'PUT', + 'path' : `/1.1/classes/Counter/${objectId}`, + 'body' : { + 'time': { + '__op' : 'Increment', + 'amount': 1 + } + } + }; + } + + // 校验是否为有效的 Host + function validHost() { + if (CONFIG.web_analytics.leancloud.ignore_local) { + var hostname = window.location.hostname; + if (hostname === 'localhost' || hostname === '127.0.0.1') { + return false; + } + } + return true; + } + + // 校验是否为有效的 UV + function validUV() { + var key = 'LeanCloud_UV_Flag'; + var flag = localStorage.getItem(key); + if (flag) { + // 距离标记小于 24 小时则不计为 UV + if (new Date().getTime() - parseInt(flag, 10) <= 86400000) { + return false; + } + } + localStorage.setItem(key, new Date().getTime().toString()); + return true; + } + + function addCount(Counter) { + var enableIncr = CONFIG.web_analytics.enable && !Fluid.ctx.dnt && validHost(); + var getterArr = []; + var incrArr = []; + + // 请求 PV 并自增 + var pvCtn = document.querySelector('#leancloud-site-pv-container'); + if (pvCtn) { + var pvGetter = getRecord(Counter, 'site-pv').then((record) => { + enableIncr && incrArr.push(buildIncrement(record.objectId)); + var ele = document.querySelector('#leancloud-site-pv'); + if (ele) { + ele.innerText = (record.time || 0) + (enableIncr ? 1 : 0); + pvCtn.style.display = 'inline'; + } + }); + getterArr.push(pvGetter); + } + + // 请求 UV 并自增 + var uvCtn = document.querySelector('#leancloud-site-uv-container'); + if (uvCtn) { + var uvGetter = getRecord(Counter, 'site-uv').then((record) => { + var incrUV = validUV() && enableIncr; + incrUV && incrArr.push(buildIncrement(record.objectId)); + var ele = document.querySelector('#leancloud-site-uv'); + if (ele) { + ele.innerText = (record.time || 0) + (incrUV ? 1 : 0); + uvCtn.style.display = 'inline'; + } + }); + getterArr.push(uvGetter); + } + + // 如果有页面浏览数节点，则请求浏览数并自增 + var viewCtn = document.querySelector('#leancloud-page-views-container'); + if (viewCtn) { + var path = eval(CONFIG.web_analytics.leancloud.path || 'window.location.pathname'); + var target = decodeURI(path.replace(/\/*(index.html)?$/, '/')); + var viewGetter = getRecord(Counter, target).then((record) => { + enableIncr && incrArr.push(buildIncrement(record.objectId)); + var ele = document.querySelector('#leancloud-page-views'); + if (ele) { + ele.innerText = (record.time || 0) + (enableIncr ? 1 : 0); + viewCtn.style.display = 'inline'; + } + }); + getterArr.push(viewGetter); + } + + // 如果启动计数自增，批量发起自增请求 + if (enableIncr) { + Promise.all(getterArr).then(() => { + incrArr.length > 0 && increment(Counter, incrArr); + }); + } + } + + var appId = CONFIG.web_analytics.leancloud.app_id; + var appKey = CONFIG.web_analytics.leancloud.app_key; + var serverUrl = CONFIG.web_analytics.leancloud.server_url; + + if (!appId) { + throw new Error('LeanCloud appId is empty'); + } + if (!appKey) { + throw new Error('LeanCloud appKey is empty'); + } + + function fetchData(api_server) { + var Counter = (method, url, data) => { + return fetch(`${api_server}/1.1${url}`, { + method, + headers: { + 'X-LC-Id' : appId, + 'X-LC-Key' : appKey, + 'Content-Type': 'application/json' + }, + body: JSON.stringify(data) + }); + }; + + addCount(Counter); + } + + var apiServer = serverUrl || `https://${appId.slice(0, 8).toLowerCase()}.api.lncldglobal.com`; + + if (apiServer) { + fetchData(apiServer); + } else { + fetch('https://app-router.leancloud.cn/2/route?appId=' + appId) + .then(resp => resp.json()) + .then((data) => { + if (data.api_server) { + fetchData('https://' + data.api_server); + } + }); + } +})(window, document); diff --git a/js/local-search.js b/js/local-search.js new file mode 100644 index 00000000..0784a80a --- /dev/null +++ b/js/local-search.js @@ -0,0 +1,159 @@ +/* global CONFIG */ + +(function() { + // Modified from [hexo-generator-search](https://github.com/wzpan/hexo-generator-search) + function localSearchFunc(path, searchSelector, resultSelector) { + 'use strict'; + // 0x00. environment initialization + var $input = jQuery(searchSelector); + var $result = jQuery(resultSelector); + + if ($input.length === 0) { + // eslint-disable-next-line no-console + throw Error('No element selected by the searchSelector'); + } + if ($result.length === 0) { + // eslint-disable-next-line no-console + throw Error('No element selected by the resultSelector'); + } + + if ($result.attr('class').indexOf('list-group-item') === -1) { + $result.html('

Loading...
'); + } + + jQuery.ajax({ + // 0x01. load xml file + url : path, + dataType: 'xml', + success : function(xmlResponse) { + // 0x02. parse xml file + var dataList = jQuery('entry', xmlResponse).map(function() { + return { + title : jQuery('title', this).text(), + content: jQuery('content', this).text(), + url : jQuery('url', this).text() + }; + }).get(); + + if ($result.html().indexOf('list-group-item') === -1) { + $result.html(''); + } + + $input.on('input', function() { + // 0x03. parse query to keywords list + var content = $input.val(); + var resultHTML = ''; + var keywords = content.trim().toLowerCase().split(/[\s-]+/); + $result.html(''); + if (content.trim().length <= 0) { + return $input.removeClass('invalid').removeClass('valid'); + } + // 0x04. perform local searching + dataList.forEach(function(data) { + var isMatch = true; + if (!data.title || data.title.trim() === '') { + data.title = 'Untitled'; + } + var orig_data_title = data.title.trim(); + var data_title = orig_data_title.toLowerCase(); + var orig_data_content = data.content.trim().replace(/<[^>]+>/g, ''); + var data_content = orig_data_content.toLowerCase(); + var data_url = data.url; + var index_title = -1; + var index_content = -1; + var first_occur = -1; + // Skip matching when content is included in search and content is empty + if (CONFIG.include_content_in_search && data_content === '') { + isMatch = false; + } else { + keywords.forEach(function (keyword, i) { + index_title = data_title.indexOf(keyword); + index_content = data_content.indexOf(keyword); + + if (index_title < 0 && index_content < 0) { + isMatch = false; + } else { + if (index_content < 0) { + index_content = 0; + } + if (i === 0) { + first_occur = index_content; + } + } + }); + } + // 0x05. show search results + if (isMatch) { + resultHTML += '' + orig_data_title + ''; + var content = orig_data_content; + if (first_occur >= 0) { + // cut out 100 characters + var start = first_occur - 20; + var end = first_occur + 80; + + if (start < 0) { + start = 0; + } + + if (start === 0) { + end = 100; + } + + if (end > content.length) { + end = content.length; + } + + var match_content = content.substring(start, end); + + // highlight all keywords + keywords.forEach(function(keyword) { + var regS = new RegExp(keyword, 'gi'); + match_content = match_content.replace(regS, '' + keyword + ''); + }); + + resultHTML += '

' + match_content + '...

'; + } + } + }); + if (resultHTML.indexOf('list-group-item') === -1) { + return $input.addClass('invalid').removeClass('valid'); + } + $input.addClass('valid').removeClass('invalid'); + $result.html(resultHTML); + }); + } + }); + } + + function localSearchReset(searchSelector, resultSelector) { + 'use strict'; + var $input = jQuery(searchSelector); + var $result = jQuery(resultSelector); + + if ($input.length === 0) { + // eslint-disable-next-line no-console + throw Error('No element selected by the searchSelector'); + } + if ($result.length === 0) { + // eslint-disable-next-line no-console + throw Error('No element selected by the resultSelector'); + } + + $input.val('').removeClass('invalid').removeClass('valid'); + $result.html(''); + } + + var modal = jQuery('#modalSearch'); + var searchSelector = '#local-search-input'; + var resultSelector = '#local-search-result'; + modal.on('show.bs.modal', function() { + var path = CONFIG.search_path || '/local-search.xml'; + localSearchFunc(path, searchSelector, resultSelector); + }); + modal.on('shown.bs.modal', function() { + jQuery('#local-search-input').focus(); + }); + modal.on('hidden.bs.modal', function() { + localSearchReset(searchSelector, resultSelector); + }); +})(); diff --git a/js/plugins.js b/js/plugins.js new file mode 100644 index 00000000..2a364b04 --- /dev/null +++ b/js/plugins.js @@ -0,0 +1,164 @@ +/* global Fluid, CONFIG */ + +HTMLElement.prototype.wrap = function(wrapper) { + this.parentNode.insertBefore(wrapper, this); + this.parentNode.removeChild(this); + wrapper.appendChild(this); +}; + +Fluid.plugins = { + + typing: function(text) { + if (!('Typed' in window)) { return; } + + var typed = new window.Typed('#subtitle', { + strings: [ + ' ', + text + ], + cursorChar: CONFIG.typing.cursorChar, + typeSpeed : CONFIG.typing.typeSpeed, + loop : CONFIG.typing.loop + }); + typed.stop(); + var subtitle = document.getElementById('subtitle'); + if (subtitle) { + subtitle.innerText = ''; + } + jQuery(document).ready(function() { + typed.start(); + }); + }, + + fancyBox: function(selector) { + if (!CONFIG.image_zoom.enable || !('fancybox' in jQuery)) { return; } + + jQuery(selector || '.markdown-body :not(a) > img, .markdown-body > img').each(function() { + var $image = jQuery(this); + var imageUrl = $image.attr('data-src') || $image.attr('src') || ''; + if (CONFIG.image_zoom.img_url_replace) { + var rep = CONFIG.image_zoom.img_url_replace; + var r1 = rep[0] || ''; + var r2 = rep[1] || ''; + if (r1) { + if (/^re:/.test(r1)) { + r1 = r1.replace(/^re:/, ''); + var reg = new RegExp(r1, 'gi'); + imageUrl = imageUrl.replace(reg, r2); + } else { + imageUrl = imageUrl.replace(r1, r2); + } + } + } + var $imageWrap = $image.wrap(` + ` + ).parent('a'); + if ($imageWrap.length !== 0) { + if ($image.is('.group-image-container img')) { + $imageWrap.attr('data-fancybox', 'group').attr('rel', 'group'); + } else { + $imageWrap.attr('data-fancybox', 'default').attr('rel', 'default'); + } + + var imageTitle = $image.attr('title') || $image.attr('alt'); + if (imageTitle) { + $imageWrap.attr('title', imageTitle).attr('data-caption', imageTitle); + } + } + }); + + jQuery.fancybox.defaults.hash = false; + jQuery('.fancybox').fancybox({ + loop : true, + helpers: { + overlay: { + locked: false + } + } + }); + }, + + imageCaption: function(selector) { + if (!CONFIG.image_caption.enable) { return; } + + jQuery(selector || `.markdown-body > p > img, .markdown-body > figure > img, + .markdown-body > p > a.fancybox, .markdown-body > figure > a.fancybox`).each(function() { + var $target = jQuery(this); + var $figcaption = $target.next('figcaption'); + if ($figcaption.length !== 0) { + $figcaption.addClass('image-caption'); + } else { + var imageTitle = $target.attr('title') || $target.attr('alt'); + if (imageTitle) { + $target.after(``); + } + } + }); + }, + + codeWidget() { + var enableLang = CONFIG.code_language.enable && CONFIG.code_language.default; + var enableCopy = CONFIG.copy_btn && 'ClipboardJS' in window; + if (!enableLang && !enableCopy) { + return; + } + + function getBgClass(ele) { + return Fluid.utils.getBackgroundLightness(ele) >= 0 ? 'code-widget-light' : 'code-widget-dark'; + } + + var copyTmpl = ''; + copyTmpl += '
'; + copyTmpl += 'LANG'; + copyTmpl += '
'; + jQuery('.markdown-body pre').each(function() { + var $pre = jQuery(this); + if ($pre.find('code.mermaid').length > 0) { + return; + } + if ($pre.find('span.line').length > 0) { + return; + } + + var lang = ''; + + if (enableLang) { + lang = CONFIG.code_language.default; + if ($pre[0].children.length > 0 && $pre[0].children[0].classList.length >= 2 && $pre.children().hasClass('hljs')) { + lang = $pre[0].children[0].classList[1]; + } else if ($pre[0].getAttribute('data-language')) { + lang = $pre[0].getAttribute('data-language'); + } else if ($pre.parent().hasClass('sourceCode') && $pre[0].children.length > 0 && $pre[0].children[0].classList.length >= 2) { + lang = $pre[0].children[0].classList[1]; + $pre.parent().addClass('code-wrapper'); + } else if ($pre.parent().hasClass('markdown-body') && $pre[0].classList.length === 0) { + $pre.wrap('
'); + } + lang = lang.toUpperCase().replace('NONE', CONFIG.code_language.default); + } + $pre.append(copyTmpl.replace('LANG', lang).replace('code-widget">', + getBgClass($pre[0]) + (enableCopy ? ' code-widget copy-btn" data-clipboard-snippet>' : ' code-widget">'))); + + if (enableCopy) { + var clipboard = new ClipboardJS('.copy-btn', { + target: function(trigger) { + var nodes = trigger.parentNode.childNodes; + for (var i = 0; i < nodes.length; i++) { + if (nodes[i].tagName === 'CODE') { + return nodes[i]; + } + } + } + }); + clipboard.on('success', function(e) { + e.clearSelection(); + e.trigger.innerHTML = e.trigger.innerHTML.replace('icon-copy', 'icon-success'); + setTimeout(function() { + e.trigger.innerHTML = e.trigger.innerHTML.replace('icon-success', 'icon-copy'); + }, 2000); + }); + } + }); + } +}; diff --git a/js/umami-view.js b/js/umami-view.js new file mode 100644 index 00000000..6ee3f6a8 --- /dev/null +++ b/js/umami-view.js @@ -0,0 +1,99 @@ +// 从配置文件中获取 umami 的配置 +const website_id = CONFIG.web_analytics.umami.website_id; +// 拼接请求地址 +const request_url = `${CONFIG.web_analytics.umami.api_server}/websites/${website_id}/stats`; + +const start_time = new Date(CONFIG.web_analytics.umami.start_time).getTime(); +const end_time = new Date().getTime(); +const token = CONFIG.web_analytics.umami.token; + +// 检查配置是否为空 +if (!website_id) { + throw new Error("Umami website_id is empty"); +} +if (!request_url) { + throw new Error("Umami request_url is empty"); +} +if (!start_time) { + throw new Error("Umami start_time is empty"); +} +if (!token) { + throw new Error("Umami token is empty"); +} + +// 构造请求参数 +const params = new URLSearchParams({ + startAt: start_time, + endAt: end_time, +}); +// 构造请求头 +const request_header = { + method: "GET", + headers: { + "Content-Type": "application/json", + "x-umami-api-key": "oZKCH3msvqt10VlXKwoJvHclmaS4bVx0", + }, +}; + +// 获取站点统计数据 +async function siteStats() { + try { + const response = await fetch(`${request_url}?${params}`, request_header); + const data = await response.json(); + const uniqueVisitors = data.uniques.value; // 获取独立访客数 + const pageViews = data.pageviews.value; // 获取页面浏览量 + + let pvCtn = document.querySelector("#umami-site-pv-container"); + if (pvCtn) { + let ele = document.querySelector("#umami-site-pv"); + if (ele) { + ele.textContent = pageViews; // 设置页面浏览量 + pvCtn.style.display = "inline"; // 将元素显示出来 + } + } + + let uvCtn = document.querySelector("#umami-site-uv-container"); + if (uvCtn) { + let ele = document.querySelector("#umami-site-uv"); + if (ele) { + ele.textContent = uniqueVisitors; + uvCtn.style.display = "inline"; + } + } + } catch (error) { + console.error(error); + return "-1"; + } +} + +// 获取页面浏览量 +async function pageStats(path) { + try { + const response = await fetch(`${request_url}?${params}&url=${path}`, request_header); + const data = await response.json(); + const pageViews = data.pageviews.value; + + let viewCtn = document.querySelector("#umami-page-views-container"); + if (viewCtn) { + let ele = document.querySelector("#umami-page-views"); + if (ele) { + ele.textContent = pageViews; + viewCtn.style.display = "inline"; + } + } + } catch (error) { + console.error(error); + return "-1"; + } +} + +siteStats(); + +// 获取页面容器 +let viewCtn = document.querySelector("#umami-page-views-container"); +// 如果页面容器存在，则获取页面浏览量 +if (viewCtn) { + let path = window.location.pathname; + let target = decodeURI(path.replace(/\/*(index.html)?$/, "/")); + pageStats(target); +} diff --git a/js/utils.js b/js/utils.js new file mode 100644 index 00000000..d61bc264 --- /dev/null +++ b/js/utils.js @@ -0,0 +1,245 @@ +/* global Fluid, CONFIG */ + +window.requestAnimationFrame = window.requestAnimationFrame || window.webkitRequestAnimationFrame || window.mozRequestAnimationFrame; + +Fluid.utils = { + + listenScroll: function(callback) { + var dbc = new Debouncer(callback); + window.addEventListener('scroll', dbc, false); + dbc.handleEvent(); + return dbc; + }, + + unlistenScroll: function(callback) { + window.removeEventListener('scroll', callback); + }, + + listenDOMLoaded(callback) { + if (document.readyState !== 'loading') { + callback(); + } else { + document.addEventListener('DOMContentLoaded', function () { + callback(); + }); + } + }, + + scrollToElement: function(target, offset) { + var of = jQuery(target).offset(); + if (of) { + jQuery('html,body').animate({ + scrollTop: of.top + (offset || 0), + easing : 'swing' + }); + } + }, + + elementVisible: function(element, offsetFactor) { + offsetFactor = offsetFactor && offsetFactor >= 0 ? offsetFactor : 0; + var rect = element.getBoundingClientRect(); + const viewportHeight = window.innerHeight || document.documentElement.clientHeight; + return ( + (rect.top >= 0 && rect.top <= viewportHeight * (1 + offsetFactor) + rect.height / 2) || + (rect.bottom >= 0 && rect.bottom <= viewportHeight * (1 + offsetFactor) + rect.height / 2) + ); + }, + + waitElementVisible: function(selectorOrElement, callback, offsetFactor) { + var runningOnBrowser = typeof window !== 'undefined'; + var isBot = (runningOnBrowser && !('onscroll' in window)) + || (typeof navigator !== 'undefined' && /(gle|ing|ro|msn)bot|crawl|spider|yand|duckgo/i.test(navigator.userAgent)); + if (!runningOnBrowser || isBot) { + return; + } + + offsetFactor = offsetFactor && offsetFactor >= 0 ? offsetFactor : 0; + + function waitInViewport(element) { + Fluid.utils.listenDOMLoaded(function() { + if (Fluid.utils.elementVisible(element, offsetFactor)) { + callback(); + return; + } + if ('IntersectionObserver' in window) { + var io = new IntersectionObserver(function(entries, ob) { + if (entries[0].isIntersecting) { + callback(); + ob.disconnect(); + } + }, { + threshold : [0], + rootMargin: (window.innerHeight || document.documentElement.clientHeight) * offsetFactor + 'px' + }); + io.observe(element); + } else { + var wrapper = Fluid.utils.listenScroll(function() { + if (Fluid.utils.elementVisible(element, offsetFactor)) { + Fluid.utils.unlistenScroll(wrapper); + callback(); + } + }); + } + }); + } + + if (typeof selectorOrElement === 'string') { + this.waitElementLoaded(selectorOrElement, function(element) { + waitInViewport(element); + }); + } else { + waitInViewport(selectorOrElement); + } + }, + + waitElementLoaded: function(selector, callback) { + var runningOnBrowser = typeof window !== 'undefined'; + var isBot = (runningOnBrowser && !('onscroll' in window)) + || (typeof navigator !== 'undefined' && /(gle|ing|ro|msn)bot|crawl|spider|yand|duckgo/i.test(navigator.userAgent)); + if (!runningOnBrowser || isBot) { + return; + } + + if ('MutationObserver' in window) { + var mo = new MutationObserver(function(records, ob) { + var ele = document.querySelector(selector); + if (ele) { + callback(ele); + ob.disconnect(); + } + }); + mo.observe(document, { childList: true, subtree: true }); + } else { + Fluid.utils.listenDOMLoaded(function() { + var waitLoop = function() { + var ele = document.querySelector(selector); + if (ele) { + callback(ele); + } else { + setTimeout(waitLoop, 100); + } + }; + waitLoop(); + }); + } + }, + + createScript: function(url, onload) { + var s = document.createElement('script'); + s.setAttribute('src', url); + s.setAttribute('type', 'text/javascript'); + s.setAttribute('charset', 'UTF-8'); + s.async = false; + if (typeof onload === 'function') { + if (window.attachEvent) { + s.onreadystatechange = function() { + var e = s.readyState; + if (e === 'loaded' || e === 'complete') { + s.onreadystatechange = null; + onload(); + } + }; + } else { + s.onload = onload; + } + } + var ss = document.getElementsByTagName('script'); + var e = ss.length > 0 ? ss[ss.length - 1] : document.head || document.documentElement; + e.parentNode.insertBefore(s, e.nextSibling); + }, + + createCssLink: function(url) { + var l = document.createElement('link'); + l.setAttribute('rel', 'stylesheet'); + l.setAttribute('type', 'text/css'); + l.setAttribute('href', url); + var e = document.getElementsByTagName('link')[0] + || document.getElementsByTagName('head')[0] + || document.head || document.documentElement; + e.parentNode.insertBefore(l, e); + }, + + loadComments: function(selector, loadFunc) { + var ele = document.querySelector('#comments[lazyload]'); + if (ele) { + var callback = function() { + loadFunc(); + ele.removeAttribute('lazyload'); + }; + Fluid.utils.waitElementVisible(selector, callback, CONFIG.lazyload.offset_factor); + } else { + loadFunc(); + } + }, + + getBackgroundLightness(selectorOrElement) { + var ele = selectorOrElement; + if (typeof selectorOrElement === 'string') { + ele = document.querySelector(selectorOrElement); + } + var view = ele.ownerDocument.defaultView; + if (!view) { + view = window; + } + var rgbArr = view.getComputedStyle(ele).backgroundColor.replace(/rgba*\(/, '').replace(')', '').split(/,\s*/); + if (rgbArr.length < 3) { + return 0; + } + var colorCast = (0.213 * rgbArr[0]) + (0.715 * rgbArr[1]) + (0.072 * rgbArr[2]); + return colorCast === 0 || colorCast > 255 / 2 ? 1 : -1; + }, + + retry(handler, interval, times) { + if (times <= 0) { + return; + } + var next = function() { + if (--times >= 0 && !handler()) { + setTimeout(next, interval); + } + }; + setTimeout(next, interval); + } + +}; + +/** + * Handles debouncing of events via requestAnimationFrame + * @see http://www.html5rocks.com/en/tutorials/speed/animations/ + * @param {Function} callback The callback to handle whichever event + */ +function Debouncer(callback) { + this.callback = callback; + this.ticking = false; +} + +Debouncer.prototype = { + constructor: Debouncer, + + /** + * dispatches the event to the supplied callback + * @private + */ + update: function() { + this.callback && this.callback(); + this.ticking = false; + }, + + /** + * ensures events don't get stacked + * @private + */ + requestTick: function() { + if (!this.ticking) { + requestAnimationFrame(this.rafCallback || (this.rafCallback = this.update.bind(this))); + this.ticking = true; + } + }, + + /** + * Attach this as the event listeners + */ + handleEvent: function() { + this.requestTick(); + } +}; diff --git a/links/index.html b/links/index.html new file mode 100644 index 00000000..9a66a362 --- /dev/null +++ b/links/index.html @@ -0,0 +1,460 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 友链 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/local-search.xml b/local-search.xml new file mode 100644 index 00000000..dc5e1088 --- /dev/null +++ b/local-search.xml @@ -0,0 +1,1054 @@ + + + + + + + hexo建站增加自己的评论模块 + + /2025/01/09/site-hexo-comment-feature/ + + jekyll时代

使用的是beaudar插件, 在更新到hexo-fluid 博客架构后仍然可以使用，
但是需要代码侵入式改造，不如fluid适配的评论体系更优雅，所以这次我们尝试一些其他的评论插件。

评论插件的挑选原则：

  • 免费：我的博客除了域名，全都是免费的，不可能为了一个评论模块而付费
  • 易接入：最后是fluid主题支持的，不然还要侵入式改造代码
  • 响应速度：希望评论模块快速响应
  • 可匿名：可以匿名发表评论，注册制会极大的影响用户发言的积极性

根据以上原则，我们对fluid官方支持的评论插件进行了筛选与评测：

beaudar

基于 GitHub Issues.博客的每次评论都会在github主站上生成一个issue，评论内容会以markdown格式保存在issue的评论区。
参考以前的文章：beaudar评论插件安装

Gitalk

基于 GitHub Issues. 通beaudar一样。

这种方式完全免费，且适合那些通过github pages 部署的博客。

安装过程

  1. 点击这里申请github 的oauth授权应用
    github oauth 注册
    按图中配置即可，地址写自己博客的地址，其他的随便写，后续还可以改。
  2. 创建app的密钥
    授权app的id和密钥
  3. _config.yml里撇嘴gitalk的配置
    fluid配置：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
post:
  comments:  # 开启评论
    enable: true
    type: gitalk # 选择评论插件类型

gitalk:
  clientID: xxxxxxxxx           # github 应用id，必须
  clientSecret: 6fcbc2edcfxxx   # github 应用密钥，必须
  repo: hanchers.github.io      # github 仓库， 必须
  owner: hancher                # github 仓库所有者， 必须
  admin: ['admin']              # github 仓库有写权限的账号
  language: zh-CN               # 语言
  labels: ['Gitalk']            # GitHub issue 的标签。
  perPage: 10                   # 每页大小
  pagerDirection: last          # 评论排序方式， last为按评论创建时间倒叙，first为按创建时间正序
  distractionFreeMode: false    # 类似Facebook评论框的全屏遮罩效果.
  createIssueManually: true     # 如果当前页面没有相应的 isssue 且登录的用户属于 admin，则会自动创建 issue。如果设置为 true，则显示一个初始化页面
  # 反向代理，为了支持 CORS. 默认的不可用，需要自己配置，参考下述文档
  # https://github.com/gitalk/gitalk/issues/429
  # https://github.com/Zibri/cloudflare-cors-anywhere
  proxy: https://shielded-brushlands-08810.herokuapp.com/https://github.com/login/oauth/access_token # 有些人搭建的代理
#  proxy: https://cors-server.68756978.xyz/github_access_token  # 备用代理地址1

效果如图，然后我们就可以评论了
gitalk评论效果图

评价

  1. 需要配置代理地址，这里有一定的开发成本，如果使用开源的，不稳定性还很高（放弃选择的主要原因）。
  2. 使用上需要注册github
  3. 响应有点慢

utterances

同样也是基于GitHub Issues实现，原理通上面的一样

安装过程

同beaudar一样，点击这里在github上安装应用。

选择你的github博客仓库。
utterances安装选择
安装好后，在_config.yml里配置utterances的配置即可

1
2
3
4
5
6
7
8
9
10
11
12
post:
  comments:  # 开启评论
    enable: true
    type: gitalk # 选择评论插件类型

# 其他配置可以参考官网
utterances:
  repo: Hanchers/Hanchers.github.io
  issue_term: pathname
  label: utterances
  theme: github-light
  theme_dark: github-dark

效果：
utterances效果

评价

  1. utterances整体上比gitalk要好一些，安装简单很多，且不用代理。
  2. 完全依赖github，这一点和beaudar一样，能满足我评价数据持久化的需求。
  3. 不幸的是，响应上，同beaudar一样，都比较慢
  4. fluid主题支持，安装很简单。
  5. 评价功能使用比较少，且不喜欢折腾的，这款插件值得推荐。

giscus

giscuss是利用 GitHub Discussions 实现的评论系统。

同上级几个评论插件不同的是，前面的是利用的GitHub Issues，而giscuss是利用GitHub Discussions。
github讨论模块
giscus 加载时，会使用 GitHub Discussions 搜索 API 根据选定的映射方式（如 URL、pathname、title 等）来查找与当前页面关联的 discussion。如果找不到匹配的 discussion，giscus bot 就会在第一次有人留下评论或回应时自动创建一个 discussion。

访客如果想要评论，必须按照 GitHub OAuth 流程授权 giscus app 代表他发布，或者可以直接在 GitHub Discussion 里评论。你可以在 GitHub 上管理评论。

安装过程

  1. 启用github仓库的Discussions功能

  2. 点击这里安装giscus应用，然后选择你开启讨论模块的仓库

  3. 点击这里按下图配置仓库名称和你的评论所有类型
    giscus配置

  4. giscus 会自动从github获取对应的id
    giscus配置结果.png

  5. 拿到id后，我们就可以在_config.yml配置了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
post:
  comments:  # 开启评论
    enable: true
    type: giscus # 选择评论插件类型

# 其他配置可以参考官网
giscus:
  repo: Hanchers/Hanchers.github.io
  repo-id: Mxxx
  category: Q&A
  category-id: Dxxxx
  theme-light: light
  theme-dark: dark
  mapping: pathname
  reactions-enabled: 1
  emit-metadata: 0
  input-position: top
  lang: zh-CN

效果：
giscus效果展示.png

遇到的问题

Q：前面都配置好后，发现评论模块加载不出来，打开F12,发现请求接口报错了：Discussion not found.
A: 很多人都遇到过这个问题，解决办法就是去仓库下手动加一条评论，等一会就好了。个人理解这里是github延迟导致的。

评价

  1. 整个安装过程挺丝滑的
  2. 数据完全托管到github，完全满足我的数据持久化和免费存储的需求
  3. 效果也不错，响应速度中等
  4. 还支持表情，挺惊喜的
  5. 唯一的问题就是发表评论需要github登录，无法匿名评论
  6. 基于github托管数据的插件里最推荐此款

至此，基于github,完全免费的评论插件都比较完了，接下来就是需要第三方网站托管数据或者自建服务托管数据的评论插件了。

livere

来必力，没想到是一个韩国的网站，用来做评论数据托管等内容，需要注册。

来必力各版本的功能比较（2025-01-09）：
livere版本比较

安装过程

点击这里注册livere

注册并登录成功后，在这个页面选择city模块，然后点击“安装使用”
livere city 版本安装

安装成功后，会得到一个脚本注入代码。
livere安装代码
将上面的data-uid复制出来放到_config.yml配置里即可。

1
2
3
4
5
6
7
8
post:
  comments:  # 开启评论
    enable: true
    type: gitalk # 选择评论插件类型

# 其他配置可以参考官网
livere:
  uid: 'your uid'

效果：
livere评论模块效果
但是点击后，会弹出第三方账号登录窗口。
提示注册

评价

  1. 免费，数据能够持久保存
  2. 韩国网站，注册的过程中都是韩文，不太友好
  3. 响应速度上，有点慢，但是比utterances快一点
  4. 页面有点丑
  5. 需要qq等账号注册才能使用，不太推荐

畅言

畅言，一个国内比较老的评论插件，需要注册，可以免费存储数据。

安装过程

  1. 点击官网，注册一个账号
  2. 去官网工作台，创建一个【畅言云评】的应用
  3. 进入应用详情，在后台总览里可以看到应用的id和密钥
    畅言云评id和密钥

将上面的id和密钥复制出来，放到_config.yml配置里即可。

1
2
3
4
5
6
7
8
9
post:
  comments:  # 开启评论
    enable: true
    type: changyan # 选择评论插件类型

# 其他配置可以参考官网
changyan:
  appid: 'id'
  appkey: 'secret'

效果：
畅言云评效果

评价

  1. 畅言的网站比较老了，但是注册过程还是很简单的
  2. 从后台来看，对于评论的功能支持还是挺完善的，可以控评，也有很多其他的插件
  3. 可以免费存储数据
  4. 发布评论需要登录，门槛太高，pass.

twikoo插件

一个简洁、安全、免费的静态网站评论系统。

  • 免费搭建（使用云开发 / Vercel / 私有服务器作为评论后台）
  • 简单部署（支持云开发 / Vercel 一键部署）

这是一款私有化部署的评论插件，可以在自己的服务器上部署，官方也提供了一整套云部署的免费方案，可以自行选择。
twikoo的N种云部署方式

因为是私有化部署的方案，这就涉及到数据存储的问题，官方提供的方案是使用mongodb的免费存储服务，需要自行注册。

安装过程

无论哪一种方案都设计到mongodb数据库的申请，所以第一步就是要申请mongodb免费版。

mongodb申请

参考官方文章,写的很详细了。

netlify安装

因为网速和流量的原因，我选择的是netlify做我的评论插件托管云服务。

  1. 打开 twikoojs/twikoo-netlify 点击 fork 将仓库 fork 到自己的账号下,后面netlify部署的时候会用到这个仓库。
  2. 点击这里 注册netlify账号，可能需要翻墙，使用github账号登录。
  3. netlify注册的时候可以选择仅授权上面fork的【twikoo-netlify】库
  4. 进入netlify控制台，点击【import an existing site】，然后选择上面fork的【twikoo-netlify】库.
    netlify新建site页面
  5. 配置环境变量，配置你的域名和mongodb的MONGODB_URI，值就是mongodb 申请里获得的nodejs 连接url
    配置mongodb环境变量
  6. 点击deploy，等待部署完成。 然后请求你配置的域名https://xxxxx.netlify.app/ ，如果看到如下内容，说明部署成功。
1
2
3
4
5
{
"code": 100,
"message": "Twikoo 云函数运行正常，请参考 https://twikoo.js.org/frontend.html 完成前端的配置",
"version": "1.6.41"
}
  1. 配置完成后，就可以在_config.yml配置twikoo了。
1
2
3
4
5
6
7
8
9
10
post:
  comments:  # 开启评论
    enable: true
    type: twikoo # 选择评论插件类型

# 其他配置可以参考官网
twikoo:
  envId: https://xxxxxxxxxx.netlify.app/.netlify/functions/twikoo
  region: ap-shanghai
  path: window.location.pathname

效果：
twikoo效果

其他部署方式

基于腾讯云的twikoo部署方案， 注意因为腾讯云免费额度已经没有了，这个方案已经失效，仅供学习参考。

评价

  1. 因为是私有化部署，过程比较复杂
  2. 整个过程都是免费的资源，满足我的免费持久化需求
  3. 评论可以匿名，不用注册，比较友好
  4. 页面也比较美观，支持评论的评论，最终选择了这个。

最后pass掉的插件

  • Valine: 基于 LeanCloud，这个有免费的存储空间。但是国内的LeanCloud 账号需要域名备案，要使用身份证等认证，接入很麻烦，遂放弃。
  • Waline: 从 Valine 衍生而来，放弃原因同上
  • Disqus: 国内用户直接使用容易被墙，直接放弃
  • remark42: 需要自建托管服务，直接放弃

总结

折腾了两天，终于把几款评论插件验证完了。

整体来看，有两款效果比较好，分别是twikoo和giscus。

  • giscus: 安装比较简单，数据托管在github, 但评论需要github账号登录，适合那些快速上手的博主。
  • twikoo: 安装比较复杂，需要申请mongodb数据库，申请云服务免费资源，适合那些喜欢折腾的博主。

todo

  • 等我的域名备案成功了，再尝试一下valine和waline
  • 找个时间试一下twikoo的私有化部署方式

最后，您觉得还有什么要补充的吗？

]]> + + + + + 网站 + + + + + + + 建站 + + 评论插件 + + hexo + + + + + + + + + jekyll迁移到Hexo博客架构全过程 + + /2025/01/07/site-hexo-from-jekyll/ + + 为什么要迁移到hexo

什么是Hexo

Hexo 是一个快速、简洁且高效的博客框架（使用NodeJs）。 Hexo 使用 Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

为什么选择了Hexo

  1. 好看，好看，好看
  2. 其中的归档功能做的很好，支持分组、也支持标签
  3. 很好的集成了网站统计相关的功能

迁移过程

Hexo环境搭建

  1. 首先确保安装了nodejs和git
    因为 Hexo 是基于 nodejs 的，所以需要先安装 nodejs，这里我使用的是 nvm 管理 nodejs 版本，安装好 nvm 后，执行 nvm install nodejs 安装 nodejs。

我安装的是2025年1月最新lts版本的nodejs: v22.12.0

  1. 安装Hexo
1
npm install -g hexo-cli

因为我的nodejs是最新版本，所以我的hexo版本是也是当前最新版本： 7.3.0

创建Hexo博客网站

选择一个你想创建项目代码的位置，执行以下命令创建Hexo博客网站：

1
2
3
4
5
6
7
# 选择合适的nodejs 版本
nvm use v22.12.0
# 创建项目
hexo init my_blod
cd my_blod
# 初始化依赖
npm install

然后我们就得到了一个默认的博客项目my_blog，其中的package.json文件如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": "7.3.0"
  },
  "dependencies": {
    "hexo": "^7.3.0",
    "hexo-generator-archive": "^2.0.0",
    "hexo-generator-category": "^2.0.0",
    "hexo-generator-index": "^4.0.0",
    "hexo-generator-tag": "^2.0.0",
    "hexo-renderer-ejs": "^2.0.0",
    "hexo-renderer-marked": "^7.0.0",
    "hexo-renderer-stylus": "^3.0.1",
    "hexo-server": "^3.0.0",
    "hexo-theme-fluid": "^1.9.8",
    "hexo-theme-landscape": "^1.0.0"
  }
}

到了这一步，我们就可以启动最原始版本的项目了：

1
2
3
4
cd my_blod
hexo server
# or 
npm run server

然后访问 http://localhost:4000 就可以看到默认的博客了。
hexo默认主题页面
官方给我们创建了一个hello world的博客. 我们可以参考这个来写我们自己的博客了。

常用的hexo命令参考这里

安装我喜欢的主题Fluid

当然这里可以使用任何你喜欢的主题，安装模式大同小异。

  1. 安装Fluid主题的最新版本
1
2
cd my_blod
npm install --save hexo-theme-fluid
  1. 配置主题
    如下修改 Hexo 博客目录中的 _config.yml：
1
2
3
theme: fluid  # 指定主题

language: zh-CN  # 指定语言，会影响主题显示的语言，按需修改
  1. 创建【关于页】
    首次使用主题的「关于页」需要手动创建：
1
hexo new page about

创建成功后修改 /source/about/index.md，添加 layout 属性，。

1
2
3
4
5
6
---
title: 标题
layout: about
---

这里写关于页的正文，支持 Markdown, HTML

layout: about 必须存在，并且不能修改成其他值，否则不会显示头像等样式。

fluid主题启动后的博客页面

迁移jekyll博客文章

文章迁移

  1. 把 _posts 文件夹内的所有文件复制到 source/_posts 文件夹
  2. 在 _config.yml 中修改 new_post_name 参数
1
new_post_name: :year-:month-:day-:title.md
  1. 如果不想使用步骤2，也可以把所有的文章的文件名的年月日前缀去掉，也可以（作为轻度洁癖患者，我选的这种方式）。

图片迁移

原先我的所有的图片资源都是在项目的根目录下的 /images 路径下，然后在文章里通过markdown的图片引用方式引用。

迁移到hexo后，只需将images目录 移动到 source 路径下，其他的都不用动，图片就可以自动解析了。

因为hexo 会将source目录下的所有文件都移动到网站的根路径下，所以图片的最终引用地址是一样的。

网站配置修改

通用hexo配置按照如下配置修改 _config.yml 文件：

1
2
3
4
5
# 网站名称
title: 寒澈笔记
subtitle: '一个程序员眼中的世界'
# 网站路径
url: https://www.hancher.top

fluid主题配置特性配置修改如下文件_config.fluid.yml， 会根据主题配置自动选择相应主题的配置。
而且这里的配置优先级最高，会覆盖_config.yml配置。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# fluid 主题配置

# 网站配置
## 头部
navbar:
  # 博客标题
  blog_title: 寒澈笔记
  # 可以自定义导航栏
#  menu:
#    - { key: 'home', link: '/', icon: 'iconfont icon-home-fill' }
#    - { key: 'tag', link: '/tags/', icon: 'iconfont icon-tags-fill' }
#    - { key: 'about', link: '/about/', icon: 'iconfont icon-user-fill', name: '联系我' }

## 底部
footer:
  statistics:
    enable: true
    source: "busuanzi"  # 可选 leancloud | busuanzi  根据自己需求选择
    pv_format: "总访问量 {} 次"  # 显示的文本，{}是数字的占位符（必须包含)，下同
    uv_format: "总访客数 {} 人"

force_https: false  # 强制https

# 内容配置
## 首页
index:
  slogan:
    enable: true
    text: 人生总有一些东西值得回忆

about:
  name: "寒澈"
  intro: "一名喜欢文史哲的程序员"
  icons:  # 不要把 icon 注释掉，否则无法覆盖配置
   - { class: 'iconfont icon-github-fill', link: 'https://github.com/Hanchers/hanchers.github.io' }
   - { class: 'iconfont icon-zhihu-fill', link: 'https://www.zhihu.com/people/bh.zhi' }
   - { class: 'iconfont icon-wechat2-fill', qrcode: '/images/about/see-history.jpg' }

## 文章
post:
  meta:
    author:  # 作者，优先根据 front-matter 里 author 字段，其次是 hexo 配置中 author 值
      enable: false
    date:  # 文章日期，优先根据 front-matter 里 date 字段，其次是 md 文件日期
      enable: false
      format: "dddd, MMMM Do YYYY, h:mm a"  # 格式参照 ISO-8601 日期格式化
    wordcount:  # 字数统计
      enable: true
      format: "{} 字"  # 显示的文本，{}是数字的占位符（必须包含)，下同
    min2read:  # 阅读时间
      enable: true
      format: "{} 分钟"
    views:  # 阅读次数
      enable: true
      source: "busuanzi"  # 统计数据来源，可选：leancloud | busuanzi   注意不蒜子会间歇抽风
      format: "{} 次"
  copyright:  # 版权声明
    license: 'BY-NC-ND'
    update_date:   # 来源 front-matter 里 updated 字段
      enable: true

github pages 配置修改

我是用的私有项目，然后通过github action的方式来自动编译部署github pages的， 具体可以参考我的历史文章，有记录。

这里要做的是在github 上重新配置hexo环境和 打包脚本。

进入本地项目的 .github/workflows目录下，删除以前的workflow文件，然后新建一个文件，文件名随意，内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# ci name
# ci 脚本名称
name: Deploy Hexo site to public github repos

on:
  # Runs on pushes targeting the default branch
  # 当代码 push 到 main 分支时, 执行该脚本
  push:
    branches:
      - main

  # Allows you to run this workflow manually from the Actions tab
  # 允许你 手动执行 这个脚本
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
# GITHUB_TOKEN 的操作权限
permissions:
  contents: read
  pages: write
  id-token: write

# Allow one concurrent deployment
concurrency:
  group: "pages"
  cancel-in-progress: true

# job 执行任务, 可以有多个, 默认并行运行, 可以通过 needs 关键字来设置依赖的其他 jobs
# step : 任务下的执行步骤, 一个job 会有多个步骤
# 操作:  一个step 下可以执行多个操作, 通常一行脚本为一个操作
jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout版本
        uses: actions/checkout@v4
      # 准备ruby 环境
      - name: 使用Node： v22.12.0
        uses: actions/setup-node@v4
        with:
          # Examples: 20, 18.19, >=16.20.2, lts/Iron, lts/Hydrogen, *, latest, current, node
          # Ref: https://github.com/actions/setup-node#supported-version-syntax
          node-version: "22.12"
      - name: 缓存 NPM 依赖
        uses: actions/cache@v4
        with:
          path: node_modules
          key: ${{ runner.OS }}-npm-cache
          restore-keys: |
            ${{ runner.OS }}-npm-cache
      - name: 安装npm依赖
        run: npm install
      - name: 构建博客内容
        run: npm run build
      - name: 更新博客网站到public目录
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public

      - name: 部署_site到博客网站仓库
        working-directory: ./public
        run: |
          git init
          git checkout -b main
          git add -A
          git -c user.name='hancher' -c user.email='hanchers@outlook.com' commit -m 'update blog' 
          git push "https://${{github.actor}}:${{secrets.PUB_BLOG}}@github.com/Hanchers/hanchers.github.io" HEAD:main -f -q

如果不是私有项目部署的话，使用官方的配置即可。官方配置如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
name: Hexo 博客部署

on:
  push:
    branches:
      - main # default branch

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          # If your repository depends on submodule, please see: https://github.com/actions/checkout
          submodules: recursive
      - name: Use Node.js 20
        uses: actions/setup-node@v4
        with:
          # Examples: 20, 18.19, >=16.20.2, lts/Iron, lts/Hydrogen, *, latest, current, node
          # Ref: https://github.com/actions/setup-node#supported-version-syntax
          node-version: "20"
      - name: Cache NPM dependencies
        uses: actions/cache@v4
        with:
          path: node_modules
          key: ${{ runner.OS }}-npm-cache
          restore-keys: |
            ${{ runner.OS }}-npm-cache
      - name: Install Dependencies
        run: npm install
      - name: Build
        run: npm run build
      - name: Upload Pages artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public
  deploy:
    needs: build
    permissions:
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

然后就可以到 hanchers.github.io 仓库下查看博客内容是否更新成功了。

如果博客内容更新了，就可以安装你的博客地址去访问博客了。

参考

  1. hexo 建站官方文档 ↩
  2. fluid主题官方文档 ↩
  3. jekyll博客迁移到hexo ↩
]]> + + + + + 网站 + + + + + + + 建站 + + hexo + + + + + + + + + 2025年博客更新计划 + + /2025/01/03/site-plan-in-2025/ + + 2025年博客更新计划

2024年已经过去，2025年已经到来。

在过去的一年了，因为经历了很多重大的事情，比如换工作、比如结婚、再比如公众号等原因，导致这个博客更新的频率比较慢。

现在，2025年了，新的开始，我也打算重新恢复博客的更新计划，并制定一些规划，既是我这一年努力的方向，也方便在2025年末的时候回来复盘。

更新计划

网站部分

  • 现在的主题感觉有点丑，而且在文档归档方面有点不足，看到一个新的主题很喜欢，计划改造一下，可能会伤筋动骨
  • 彻底解决国内访问本网站的问题，目前发现的参考文章,有空研究一下
  • 研究一下，如何让博客拥有更新时间的功能,记录我对博客内容的修改
  • 为了加快网站的访问速度，考虑引入图床功能
  • 将上述改造整理成文档，并分享到博客

内容部分

  • 博客的定位从纯技术博客，变更为一个技术+生活类型模块，增加一些非技术类的内容
  • 我的部分改造升级，打通我的所有的内容生态体系，提升我的个人品牌
  • 计划开发一套个人的小程序，并记录小程序上线的全过程
  • 增加一些收集的资源分享功能，开源分享的精神总要有人来继承
  • 技术方面，除了日常问题的总结外，继续向上游理论部分探索

生命不息，折腾不止

发现我就是一个喜欢折腾的人

]]> + + + + + 网站 + + + + + + + 建站 + + 更新计划 + + + + + + + + + 西部数据提供免费版Paragon实现与mac电脑的读写 + + /2024/12/30/life-ntfs-for-mac-free/ + + 现象

俗套的现象：买了一个西部数据的移动硬盘，然后又买了一个mac电脑，将硬盘插入到电脑后发现硬盘里的数据可以读，但是无法将电脑里的文件写入。

其实本质上的原因就是 wb的硬盘是ntfs格式的, mac电脑不支持ntfs格式的读写.

本人电脑：macbook pro m1版

系统版本：macos 14

解决

如果为了保持和windows系统的兼容性，wb的硬盘必须使用ntfs格式，那么通过安装ntfs转换软件也能实现。mac应用商店里有很多这种软件，但是要收费。

应用商店之外常用的软件就是 uxera和Paragon，也要收费。

后来找了好久，在西部数据的官方帖子上找到一个免费实现的法子，原来西部数据官方也提供了一套mac版读写数据的驱动。

以下是官方帖子的链接：
Steps to Install Paragon NTFS Driver for macOS for WD and SanDisk Professional

大概安装步骤如下：

  1. 下载驱动
    Paragon_NTFS_Driver_for_Mac
    解压后双击软件开始安装。

  2. 选择:安装ntfs for mac
    s1
    然后接着按照步骤一直下一步就可以了
    s2
    s3
    s4
    s5
    s6

  3. 在最后一步，会要求在系统配置里代开可信任权限，关机重启。
    需要注意的是，这里不仅仅是要求在mac的系统安全设置里打开第三方软件信任项，还要在系统的安全模型里开启对第三方软件的信任项。

如果以前没有修改过安全模型下的配置，大概率会提示需要在“恢复”环境中修改安全性设置。

这个需要在电脑关机后，长按触控ID或电源按钮就能进入安全配置环境，选择设置配置，然后在上面的菜单选择里找到安全配置相关菜单，勾选信任第三方软件修改系统内核就可以了（因为是安全模式，没有截图，按照这个步骤找就可以了）。

如果对电脑安全有洁癖的用户，这一步操作要慎重，也可以转投付费阵营。

补充

因为网络的原因，上面的驱动可能是下载失败，这里提供一个备用地址：
Paragon_NTFS_Driver_for_Mac.zip 17.0.246 (访问密码: 45td)

驱动版本列表

]]> + + + + + 生活 + + + + + + + 生活 + + + + + + + + + linux安装ClamAV杀毒软件然后扫毒 + + /2024/12/25/safe-clamav-and-scan/ + + 背景

最近在一个项目上要求在linux服务器上安装杀毒软件，然后开启系统扫描，然后删除病毒。

然后找了找了一些资料，比较常用的有ClamAV 和 Comodo, 因为ClamAV开源，且使用比较广泛，最终选择了ClamAV。

我们的服务器是centos7.9, 下面就是在CentOS上安装ClamAV的过程，比较简单。

CentOS 上安装ClamAV

以下是在 CentOS 上安装 ClamAV 步骤：

步骤 1：安装 EPEL 仓库

ClamAV 通常通过 EPEL（Extra Packages for Enterprise Linux）仓库提供，因此首先需要确保 EPEL 仓库已安装。

如果失败可以考虑使用阿里云的源 yum 仓库更换阿里云

1
sudo yum install epel-release -y

步骤 2：安装 ClamAV

安装 EPEL 仓库后，你可以通过以下命令安装 ClamAV：

1
sudo yum install clamav clamav-update clamd -y
  • clamav 包含命令行工具（如 clamscan）。
  • clamav-update 是更新病毒库所需的工具（即 freshclam）。
  • clamd 是clam的系统服务。

验证安装是否成功：

1
clamscan --version

步骤 3：更新病毒库

安装完成后，首先需要更新 ClamAV 的病毒库，以确保它能识别最新的恶意软件。运行以下命令：

1
sudo freshclam

freshclam 会从 ClamAV 的服务器下载并更新病毒库，如果超时，等一会再多试几次，我试了3次成功了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
ClamAV update process started at Wed Dec 25 16:33:20 2024
WARNING: Your ClamAV installation is OUTDATED!
WARNING: Local version: 0.103.11 Recommended version: 0.103.12
DON'T PANIC! Read https://docs.clamav.net/manual/Installing.html
daily database available for download (remote version: 27497)
Time:   14.0s, ETA:    0.0s [========================>]   61.48MiB/61.48MiB
Testing database: '/var/lib/clamav/tmp.8095e9d84b/clamav-0e8a55acea5c8848d6871677901e577d.tmp-daily.cvd' ...
Database test passed.
daily.cvd updated (version: 27497, sigs: 2071426, f-level: 90, builder: raynman)
main database available for download (remote version: 62)
Time:   50.6s, ETA:    0.0s [========================>]  162.58MiB/162.58MiBBB
Testing database: '/var/lib/clamav/tmp.8095e9d84b/clamav-ac7f382ef620ff4ad4d10aaed27f9dce.tmp-main.cvd' ...
Database test passed.
main.cvd updated (version: 62, sigs: 6647427, f-level: 90, builder: sigmgr)
bytecode database available for download (remote version: 335)
Time:    1.5s, ETA:    0.0s [========================>]  282.94KiB/282.94KiB
Testing database: '/var/lib/clamav/tmp.8095e9d84b/clamav-bbc727f2e5a1bc6a0e835c65fb9cf566.tmp-bytecode.cvd' ...
Database test passed.
bytecode.cvd updated (version: 335, sigs: 86, f-level: 90, builder: raynman)

步骤 4：启动 ClamAV 守护进程（可选）

如果你希望使用 ClamAV 的守护进程（clamd），你需要启动它。守护进程会提高扫描效率，特别是对于较大的文件。

  1. 启用clam默认配置
1
2
3
cp /etc/clamd.d/scan.conf /etc/clamd.d/scan.conf.bak
sed -i -e "s/^Example/#Example/" /etc/clamd.d/scan.conf
vim /etc/clamd.d/scan.conf

放开如下的注释

1
# LocalSocket /run/clamd.scan/clamd.sock
  1. 重命名clam服务的@文件
1
mv /usr/lib/systemd/system/clamd\@.service /usr/lib/systemd/system/clamd.service
  1. 修改服务配置
1
2
3
4
5
6
7
8
9
10
11
12
[Unit]
Description = clamd scanner daemon
After = syslog.target nss-lookup.target network.target
[Service]
Type = forking
ExecStart = /usr/sbin/clamd -c /etc/clamd.d/scan.conf
# Reload the database
ExecReload=/bin/kill -USR2 $MAINPID
Restart = on-failure
TimeoutStartSec=420
[Install]
WantedBy = multi-user.target

  1. 启动 clamd 服务：

    1
    2
    sudo systemctl daemon-reload
    sudo systemctl start clamd.service

  2. 设置 clamd 在系统启动时自动启动：

    1
    sudo systemctl enable clamd.service

步骤 5：运行 ClamAV 执行病毒扫描

你可以使用 clamscan 执行病毒扫描。以下是一些常见的用法：

  • 扫描单个文件：

    1
    clamscan /path/to/file

  • 扫描整个目录：

    1
    clamscan -r /path/to/directory

  • 扫描并删除感染文件：

    1
    clamscan -r --remove /path/to/directory

  • 扫描并显示详细信息：

    1
    clamscan -r -v /path/to/directory

  • 将结果输出到文件：

    1
    2
    3
    4
    5
    clamscan -r /path/to/directory --log=clamav_scan_results.txt
    # or
    clamscan -r /path/to/directory > clamav_scan_results.txt
    # 后台运行
    nohup clamscan -r /path/to/directory --log=clamav_scan_results.txt &

    结果：

1
2
3
4
5
6
7
8
9
10
11
12
----------- SCAN SUMMARY -----------
Known viruses: 8702931
Engine version: 0.103.11
Scanned directories: 44573
Scanned files: 66053
Infected files: 0
Total errors: 21600
Data scanned: 4565.67 MB
Data read: 27114.51 MB (ratio 0.17:1)
Time: 1178.142 sec (19 m 38 s)
Start Date: 2024:12:25 17:12:38
End Date:   2024:12:25 17:32:17

步骤 6：配置 ClamAV (可选)

如果需要，你可以配置 ClamAV 来调整其行为。ClamAV 的配置文件位于：

  • clamd 配置文件：/etc/clamd.d/scan.conf
  • freshclam 配置文件：/etc/freshclam.conf

你可以编辑这些配置文件，调整日志文件路径、扫描选项等。例如，编辑 clamd 配置文件来启用详细日志：

1
sudo vi /etc/clamd.d/scan.conf

修改以下内容：

1
2
LogFile /var/log/clamd.log
LogTime yes

步骤 7：定期更新病毒库

为了确保 ClamAV 能及时识别最新的威胁，你需要定期更新病毒库。你可以通过设置 cron 任务 来自动更新病毒库。

  1. 编辑 crontab 文件：

    1
    sudo crontab -e

  2. 添加以下行来每天更新病毒库（此例为每天凌晨 2 点）：

    1
    0 2 * * * /usr/bin/freshclam --quiet

总结

  1. 安装 EPEL 仓库并通过 yum 安装 ClamAV。
  2. 使用 freshclam 更新病毒库。
  3. 启动并配置 clamd 守护进程（可选）。
  4. 使用 clamscan 执行病毒扫描。
  5. 配置定时任务自动更新病毒库。

通过这些步骤，你可以在 CentOS 上成功安装和配置 ClamAV，帮助你扫描和清理系统中的病毒和恶意软件。

参考

clamav 官方文档

yum 仓库更换阿里云

centos7 配置ClamAV

]]> + + + + + 安全 + + + + + + + linux + + 安全 + + + + + + + + + mysql出现了waiting for global read lock 全局事务等待问题排查 + + /2024/08/01/db-mysql-waiting-for-global-read-lock/ + + 问题发现

在一个普通的日子里，寒澈在操作他负责的一个内部系统的时候，突然发现一个修改状态的操作不能操作了。 查看服务器日志，发现数据库连接超时了：
mysql连接超时
第一反应是数据库挂了，导致数据库连不上了。

可是，神奇的是，接下来发现数据库的查询功能还能用，但是所有的状态修改类的写操作都不能用了。 这下知道遇到麻烦了，肯定是mysql数据库的产生锁了，把所有的写操作阻塞了。

按照现在的这个情况，mysql读没有问题，写被阻塞，出问题的锁肯定是读锁（共享锁），而且还是全局性质的，因为所有的写都被影响了。

问题定位

按照上面的思路去数据库里执行一下SHOW ENGINE INNODB STATUS, 查看一下数据库的状态。 结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
*** WE ROLL BACK TRANSACTION (2)
------------
TRANSACTIONS
------------
Trx id counter 48415098
Purge done for trx's n:o < 48412278 undo n:o < 0 state: running but idle
History list length 0
LIST OF TRANSACTIONS FOR EACH SESSION:
---TRANSACTION 421386947297640, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947296832, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947296024, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947295216, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947294408, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947293600, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947291984, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947288752, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947287944, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947287136, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947283904, not started
0 lock struct(s), heap size 1128, 0 row lock(s)
---TRANSACTION 421386947280672, not started
0 lock struct(s), heap size 1128, 0 row lock(s)

发现了大量的如上的事务在积压，没有执行。 与预期一致，就是某个锁导致事务阻塞了。

注意这里不会是死锁问题，因为死锁是锁冲突，mysql会自动解决的，不会导致事务长时间阻塞。

查询一下mysql的执行进程，看看情况：

1
2
# 查询一个耗时最久的 进程
select * from information_schema.PROCESSLIST order by time desc;

发现了如下场景
waiting for global read lock

由此我们知道：

  1. 确实发生了一个全局性的读锁waiting for global read lock导致了后续写操作的进行。 后面的事务都在等待这个读锁的释放。
  2. 情况比我们想象的严重，这个读锁不仅影响了我们自己的实例，还把整个mysql下所有的库实例都影响了。
  3. 问题的原因也发现了，就是有一个binlog dump后没有结束导致的。也就是那个耗时最久的进程。

问题解决

既然发现了这个锁产生的原因，直接把这个进程kill掉就可以了

1
kill 3518815

binlog的进程杀掉后，后面阻塞的任务果然都没了。

记录一下排查问题过程中常用的sql

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查询当前元数据锁及关联的线程和事务
select * from performance_schema.metadata_locks l
left join performance_schema.threads t on t.THREAD_ID = l.OWNER_THREAD_ID 
left join performance_schema.events_transactions_current  et on et.THREAD_ID  = t.THREAD_ID 
left join information_schema.INNODB_TRX  trx on t.PROCESSLIST_ID = trx.trx_mysql_thread_id  

# 当前系统内的事务
select * from information_schema.innodb_trx;

# 查询一个耗时最久的 进程
select * from information_schema.PROCESSLIST order by time desc;

# 查询innodb 状态
SHOW ENGINE INNODB STATUS

问题避免

发现问题，解决问题，避免问题才是我们排查问题最终要的目的。

我们这个问题是flink cdc 数据的时候导致的，后续的解决办法很简单：
第一： 以后flink 不要cdc主库了，避免对业务产生影响。
第二：flink cdc 一定要做好异常拦截处理，我们这就是因为异常导致fink退出了，无法释放锁
第三：如果可以的话，尽量使用flink的无锁cdc版本

关于这个global read lock是怎么产生的

当mysql在dump整个数据库的时候，会对数据库执行一个FLUSH TABLES WITH READ LOCK命令来加锁，这个命令会停止对所有表的写操作，‌并允许读操作继续。
等备份完成，会使用UNLOCK TABLES来解锁，

参考

mysql 加 global read lock 机制

]]> + + + + + 数据库 + + + + + + + mysql + + + + + + + + + 如果让百度爬虫爬我的github博客 + + /2024/05/22/site-how-baidu-spide-github-site/ + + 我们辛辛苦苦的通过github pages建好我们的博客之后。接下来可能会想要更多的人来访问我们的博客，
然后一顿操作后发现，github 把百度的爬虫屏蔽了，所以我们的网站也就不能被百度搜索了，我们的博客也就没法被百度搜索到了。

这怎么行呢？ 我们的博客主要群体还是国内的程序员的，少了百度这个来源，访问量一下子少了一大半。

作为一名程序员，我们怎么能被这个事情难倒呢？

让我们来分析一下，github 把百度的爬虫屏蔽了，这导致了我们的博客不能被百度收录。既然百度不能爬github了，我们可以让百度去别的地方爬我们的博客呀。

思路一开天地宽，我们可以通过CDN的机制来把我们的博客搬到CDN上，然后让百度访问CDN就可以了呀。

可惜，试过七牛云等一些国内的CDN，发现同步网站还要备案，这个我要是有，也就不用这么麻烦的想办法同步内容到百度了，这一步是走不通了。

最后，我发现了vercel这个网站，可以镜像我们的github 博客，而又没有屏蔽百度的爬虫，完美的解决了我的问题。

准备

  • github博客站建好
  • 一个域名，我们需要域名来做博客的跳转。

操作

关联vercel

  1. 注册登录vercel
  2. 新建一个项目（add new project）, 关联到自己github上的 博客仓库
    vercel关联github
  3. 添加指向vercel项目的二级域名，比如我的blog.hancher.top
    vercel配置域名
  4. 此时，我们在Vercel里的项目已经构建好了，下次 GitHub 项目的任何更新都会触发 Vercel 项目更新
    vercel效果

配置域名解析

去域名的解析后台，添加域名的CNAME解析，记录值cname-china.vercel-dns.com 此时，通过blog.hancher.top就可以访问vercel CDN上的静态网站了。

当然，也可以将记录值改为Vercel的自己项目的vercel.app 域名。将线路解析类型改为百度 亦可。

关联百度解析

  1. 去百度站点管理 里注册账号，创建blog.hancher.top域名的网站，即可以抓取我们的博客站点了。
  2. 将百度给的一个签名放到网站的根目录下
    百度站点
  3. 通过抓取诊断 来验证我们的博客是否可以正常抓取
    抓取诊断
  4. 耐心等待几天，在百度搜索框里搜索 site:blog.hancher.top来验证我们的配置是否生效，此时大概率就能搜到自己的博客文章了。
    验证博客

2024年更新

因为Vercel被墙（dns污染方式）, 该方法暂时失效。等待后续解决。

参考

知乎-如何解决百度爬虫无法爬取搭建在Github上的个人博客的问题
建站过程中的踩坑记录：自定义域名、百度收录与备案

]]> + + + + + 网站 + + + + + + + 建站 + + vercel + + 网站曝光 + + + + + + + + + springdoc-openapi的集成与常见问题 + + /2023/11/29/spring-springdoc-openapi/ + + 在项目中经常使用swagger来作为项目接口的自动化api文档，尤其是springboot项目，一般都是通过springfox-boot-starter来集成swagger的使用。
springfox-boot-starter 在2.x时代用着很方便，但是随着项目的发展，尤其是spring项目的不断推出新版本，
springfox-boot-starter在3.0版本就已经明显存在兼容性问题了，而且已经3年多没维护了，所以寻找替代品是一种虽然不紧迫但很必须的事项了。
而springdoc-openapi就是springfox-boot-starter的替代品，且获得了swagger的官方支持，算是springfox在springboot高版本的天热替代品。
springfox已经3年未更新了

本文就介绍springdoc-openapi的集成与常见问题。

项目依赖

如果你的项目是springboot2.x版本，请使用springdoc-openapi的1.x版本。
如果你的项目是springboot3.x版本，请使用springdoc-openapi的2.x版本。

本文案例的环境是：

  • java 17
  • springboot 2.7.18

开始

使用idea创建一个新的maven springboot项目，添加如下依赖

1
2
3
4
5
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-ui</artifactId>
    <version>1.7.0</version>
</dependency>

创建一个Controller

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@RestController
@RequestMapping("/hello")
@Tag(name="openapi demo")
public class HelloWorldController {

    @GetMapping("/world")
    @Operation(summary = "helloWorld接口",description = "接口描述信息")
    @Parameter(name = "name", description = "名称", required = true,  in = ParameterIn.QUERY)
    public String helloWorld(String name) {
        return "Hello "+ Optional.of(name).orElse("world");
    }

    /**
     * 隐藏的api，不再swagger 显示
     */
    @GetMapping("/hidden")
    public String hiddenApi(String name) {
        return "Hello "+ Optional.of(name).orElse("world");
    }
}

然后就可以直接启动了，不用任何配置，就可以看到swagger的界面了。
swagger默认地址： http://localhost:8080/swagger-ui/index.html#/
springdoc版的swagger的默认页面

通过配置文件修改相关配置

如果你不想使用默认的配置，可以通过配置文件修改相关配置。比如我通过下面配置对swagger的界面进行了微调。

1
2
3
4
5
6
7
8
9
# application.properties
springdoc.swagger-ui.disable-swagger-default-url=true
# 布局 StandaloneLayout，BaseLayout
springdoc.swagger-ui.layout=BaseLayout
springdoc.swagger-ui.path=/v3/swagger-ui.html
# swagger-ui 默认关联的api接口配置, 要与api-docs.path 一致。 不配置默认取api-docs.path配置
springdoc.swagger-ui.url=/v3/test/api-docs
# api json 接口配置, 可以自定义其他json接口
springdoc.api-docs.path=/v3/test/api-docs

因为修改了swagger页面的访问地址，所以我们的访问地址变成了：
http://localhost:8080/v3/swagger-ui/index.html#/
效果如图：
springdoc版的swagger的properties配置版

通过自定义配置类修改相关配置

如果我们想要更自有的配置，可以通过自定义配置类来修改相关配置。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
@Configuration
public class SwaggerConfig {
    /**
     * 添加摘要信息
     */
    @Bean
    public OpenAPI openAPI() {
        return new OpenAPI()
                .info(new Info().title("hancher demo open api")
                        .description("helloWorld接口文档")
                        .version("v3.0.0")
                        // 联系人
                        .contact(new Contact().name("寒澈").url("https://www.hancher.top/"))
                )
                // 其他文档信息
                .externalDocs(new ExternalDocumentation()
                        .description("寒澈笔记")
                        .url("https://www.hancher.top/"));
    }


    /**
     * 模式三： 自定义api分组
     *
     */
//    @Bean
    public GroupedOpenApi publicApi() {
        return GroupedOpenApi.builder()
                .packagesToScan("com.hancher.demo.springbootopenapi.controller") // 扫描包
                .displayName("寒澈openapi")
                .addOpenApiMethodFilter(method -> method.isAnnotationPresent(Operation.class))
                .build();
    }
}

还是默认访问地址：http://localhost:8080/swagger-ui/index.html#/
springdoc版的swagger的openapi配置版

迁移成本

除了将老版本的注解替换成新的注解之外，没有任何其他改的。
springfox迁移到springdoc的注解变动

集成中遇到的问题

我在集成过程中遇到的最大的问题就是明明集成好了，但是swagger的访问页面还是swagger的默认petStore的页面，而不是我配置的controller的页面。这个问题让我排查了好久。
springdoc总是显示默认petstore接口

首先，我们我们要先了解的是，swagger-ui是一套api展示页面，他的数据是从v3/api-docs接口获取的json数据。
所以排查问题，我们首先要看页面有没有调用这个接口（有可能我们在配置文件了将这个接口改了），再次看看这个接口有没有返回正常的json结果。
springdoc的数据接口
如果这这个接口返回了正常的数据，且是我们的配置的接口数据，那么问题很可能是我们的一些安全配置将swagger的相关接口给屏蔽了。
比如WebSecurityConfigurerAdapter, 我就是在这个环节上出的问题

1
2
3
4
5
6
7
8
9
@EnableGlobalMethodSecurity(prePostEnabled = true, securedEnabled = true)
public class SecurityConfig extends WebSecurityConfigurerAdapter
{
    @Override
    protected void configure(HttpSecurity httpSecurity) throws Exception
    {
        
    }
}

项目demo

集成了application，java bean config 两种方式的demo
springdoc-demo

]]> + + + + + spring + + + + + + + spring + + openapi + + + + + + + + + linux定时任务crontab不执行的问题排查过程 + + /2023/10/13/linux-linux-crontab-not-work/ + + 背景

最近在搞一个比较复杂的crontab 定时任务， 核心思路就是通过crontab触发一个bash脚本，调用docker内的一个指令，来实现docker积压日志的删除清理操作。

然后问题就来了：我通过命令行调用脚本，能够正常执行，但是通过crontab，脚本就死活调用不成功。

以下就是记录的排查crontab调用不成功的过程：

案发现场

crontab上配置定时任务,把该有的环境变量都配置上，脚本的开头也加上了source /etc/profile 为了方便排查，调度改为2分钟一次

1
*/2 * * * *  /usr/bin/docker exec -it container-name bash  -c 'sh /var/log/del_overdue_log.sh'

不出意外的话，定时任务调度失败了。

通过tail -f /var/log/cron 去cron调度日志里查看调用情况：

1
2
Oct 13 10:58:01 : CROND[27764]: (root) CMD (/usr/bin/docker exec -it container-name bash  -c 'sh /var/log/del_overdue_log.sh')
Oct 13 10:58:01 : (root) MAIL (mailed 54 bytes of output but got status 0x004b#012)

日志表示，我们的cron任务调度了，但是没有成功。 失败原因本来想通过mail发给当前root用户的，但发送失败了，原因是获得了一个失败状态吗。

如何解决这个mail发送失败的问题呢?

启用postfix 接收系统邮件

去/etc/postfix/main.cf 配置文件,搜索inet_interfaces，改成如下配置

1
2
inet_interfaces = all
# inet_interfaces = localhost

重启postfix 

1
systemctl restart postfix

此时，我们就可以收到cron调度失败的系统通知邮件了。

tail -f /var/spool/mail/root 查看邮件信息：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
From root@host.localdomain  Fri Oct 13 12:56:01 2023
Return-Path: <root@host.localdomain>
X-Original-To: root
Delivered-To: root@host.localdomain
Received: by host.localdomain (Postfix, from userid 0)
id D94301329A7; Fri, 13 Oct 2023 12:56:01 +0800 (CST)
From: "(Cron Daemon)" <root@host.localdomain>
To: root@host.localdomain
Subject: Cron <root@host> /usr/bin/docker exec -it container-name bash  -c 'sh /var/log/del_overdue_log.sh'
Content-Type: text/plain; charset=UTF-8
Auto-Submitted: auto-generated
Precedence: bulk
X-Cron-Env: <XDG_SESSION_ID=2387>
X-Cron-Env: <XDG_RUNTIME_DIR=/run/user/0>
X-Cron-Env: <LANG=en_US.UTF-8>
X-Cron-Env: <SHELL=/bin/sh>
X-Cron-Env: <HOME=/root>
X-Cron-Env: <PATH=/usr/bin:/bin>
X-Cron-Env: <LOGNAME=root>
X-Cron-Env: <USER=root>
Message-Id: <20231013045601.D94301329A7@host.localdomain>
Date: Fri, 13 Oct 2023 12:56:01 +0800 (CST)

the input device is not a TTY

会发现，失败的原因是我们的脚本调度器不是TTY(终端)，所以失败了。

注意，问题定位后记得把postfix配置恢复原状

问题定位

找到日志了，任务调度失败的原因也找到了，分析一下我们的任务指令，发现我们在脚本调度命令里存在选项 docker exec -it 配置。

问题就在这个-it 上面了，这要求我们开启一个交互式终端来控制docker指令，而crontab调度器明显不是一个终端，所以失败了。

问题解决

把命令行里的-it去掉，改为-d后端调用就可以了。以下是最终版配置

1
* 1 * * *  /usr/bin/docker exec -d container-name bash  -c 'sh /var/log/del_overdue_log.sh' >/dev/null 2>$1

最终指令改了两点:

  1. 将-it改为-d， 解决crontab调度失败的问题。
  2. 在crontab命令上增加 >/dev/null 2>$1 配置，这是为了取消任务调度的系统日志产生，防止系统日志爆炸，也可以不加。

结论

授之以渔不如授之以渔， 出现问题不可怕，只要我们掌握了一些解决问题的方法论， 任何问题都能迎刃而解。

参考

‘crontab’ in Linux with Examples

crontab不执行排查

]]> + + + + + 编程人生 + + + + + + + linux + + + + + + + + + java应用连接docker内的oracle时报ORA-01882错误 + + /2023/08/18/exception-java-oracle-docker-timezone-not-find/ + + 问题描述

数据库升级，用docker容器安装oracle11g数据库，应用连接的时候报ORA-01882错误

1
2
3
4
5
6
java.sql.SQLException: ORA-00604: error occurred at recursive SQL level 1
ORA-01882: timezone region not found

        at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:509)
        at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:456)
        at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:451)

环境：

  • jdk ： openjdk8
  • oracle: 11g

解决

问题本质上是java应用程序启动时, 找不到本地系统的时区环境变量导致。 我们只有把时区环境变量配置上就可以了。

解决办法有二：

  1. java应用程序启动时增加环境变量配置
1
-Duser.timezone=xxx（xxx为oracle时区ID）
  1. 直接修改服务器的系统环境变量（更彻底）
1
2
3
4
# 时间更新为东八区时间
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
# 配置时区为东八区。 Java可以通过Timezone获取时区的，修改完重启服务即可。
echo 'Asia/Shanghai' >/etc/timezone

如果是docker的话，将宿主机改为上述配置后，docker容器启动(run)增加挂载配置就可以了

1
2
-v /etc/localtime:/etc/localtime
-v /etc/timezone:/etc/timezone
]]> + + + + + 编程人生 + + + + + + + java + + 异常 + + oracle + + docker + + + + + + + + + git优雅迁库的方式 + + /2023/07/31/git-mirror/ + + 在我们开发项目的时候，经常会遇到将一个git仓库迁移到一个新的git仓库的情况。 这个时候很多人会把原始的仓库最新代码复制到新库目录下，然后force push即可。

但是这样会产生一个问题，就是新库会把我们的历史提交记录等信息全部丢失了，当做一个全新的仓库来处理，这样给我们后续的问题追踪回溯带来了一些问题。

下面我们介绍一下git优雅迁库的三种方式。

裸库方式(推荐)

1
2
3
4
// 使用--bare克隆裸仓库
git clone --bare git@url1
// 推送到新库
git push  git@url2

镜像库方式

1
2
3
4
// 使用--mirror克隆裸仓库
git clone --mirror git@url1
// 推送到新库
git push  git@url2

镜像库是裸库的一种简写,等同于：

1
2
$ git clone --bare $URL
$ (cd $(basename $URL) && git remote add --mirror=fetch origin $URL)

由此可知，裸库方式clone下的是git仓库的基本信息。镜像库不仅把基本信息clone下来了，还拉去了最新的分支代码。

新增remote方式

1
2
git remote add origin2 [repo-url]
git push origin2

参考

git clone –mirror 和 –bare的区别

]]> + + + + + 编程人生 + + git + + + + + + + git + + + + + + + + + jdbc反序列化漏洞修复 + + /2023/07/04/safe-mysql-jdbc-object-serial/ + + 安全漏洞描述

Jdbc反序列化漏洞发生在后台代码使用mysql-connector组件连接数据库且攻击者可控制连接参数的情况下。攻击者可以构造恶意的mysql数据库使服务器去访问链接它从而触发反序列化漏洞导致命令执行

mysql 连接参数风险点：autoDeserialize，statementInterceptors

风险等级：高

解决办法

  • 升级mysql版本到8.0.27+，官方已经修复此问题
1
2
3
4
5
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.27</version>
</dependency>
  • 过滤掉风险参数
    一般情况下不需要对autoDeserialize和statementInterceptors参数进行设置。在后端代码设置连接字符参数白名单,或者将这两个参数直接替换掉。
    替换代码参考：
1
2
3
4
5
6
7
8
Properties prop = new Properties();
prop.put("autoDeserialize", "false");
prop.put("allowLoadLocalInfile", "false");
prop.put("allowUrlInLocalInfile", "false");
prop.put("allowLoadLocalInfileInPath", "");
prop.put("statementInterceptors", "");

Connectionconn=DriverManager.getConnection(DB_URL,prop);

安全无小事！！！

Jdbc反序列化漏洞复现浅析

探探JDBC反序列化漏洞

狼组-JDBC反序列化漏洞

]]> + + + + + 安全 + + + + + + + mysql + + 安全 + + + + + + + + + CORS跨域攻击与修复 + + /2023/06/21/safe-cors-attack/ + + CORS跨域的逆向操作，如何收回放开的跨域权限。

以下是CORS漏洞的一些内容：

安全漏洞描述

Web服务端CORS（跨域资源共享）错误配置，无法正确验证Origin头，任何网站都可以发出使用用户凭据发出的请求，并读取对这些请求的响应，信任任意来源可以有效地禁用同源策略，从而允许第三方网站进行双向交互，易导致敏感信息泄露

swagger-switch

风险等级：高

解决办法

需要修复两处：
1，代码级别（必修）
程序默认是禁止跨域的，也可以去掉相关逻辑。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// 比如： *.domain.com, 127.0.0.1  
@Value("${cros.allow-origin:*}")
private String crosAllowOrigin;

@Bean
public CorsFilter corsFilter()
{
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowCredentials(false);
    // 设置访问源地址，   
    for (String origin : crosAllowOrigin.split(",")) {
        config.addAllowedOriginPattern(origin);
    }
    // 设置访问源请求头 , 也可以配置  
    config.addAllowedHeader("*");
    // 设置访问源请求方法 , 也可以配置   
    config.addAllowedMethod("*");
    // 有效期 1800秒    
    config.setMaxAge(1800L);
    // 添加映射路径，拦截一切请求    
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/**", config);
    // 返回新的CorsFilter    
    return new CorsFilter(source);
}

2，nginx服务
增加相关头配置

1
add_header Access-Control-Allow-Origin your.domain.com;

安全无小事！！！

]]> + + + + + 安全 + + + + + + + spring + + 安全 + + + + + + + + + 存储XSS问题与修复 + + /2023/06/21/safe-xss-reactive/ + + 安全漏洞描述

恶意攻击者往Web页面里插入恶意Script代码，当用户浏览该页时，嵌入其中Web里面的Script代码会被执行，进而窃取到管理员用户权限等。

风险等级：高

解决办法

  1. 对网页端输入的特殊字符过滤
    建议过滤的关键字为：
    [1]’单引号
    [2]”双引号
    [3]/斜杠
    [4]反斜杠
    [5])括号
    [6];分号
    [7][中括号
    [8]<尖括号
    [9]>尖括号
    比如把<编码为<
  2. 在cookie中加入httponly属性可以在一定程度上保护用户的cookie，减少出现XSS时损失。

一段简易的字符过滤程序

1
2
3
4
5
6
7
8
9
10
function htmlEncode(str){
    var s = "";
    if (str.length == 0) return "";
    s = str.replace(/&/g, "&");
    s = s.replace(//g, ">");
    s = s.replace(/ /g, " ");
    s = s.replace(/\'/g, "'");
    s = s.replace(/\"/g, """);
    return s;
}
  1. 在服务端增加filter过滤
    通过自定义filter的方式拦截过滤请求
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
public class XssFilter implements Filter
{
    /**
     * 排除链接
     */
    public List<String> excludes = new ArrayList<>();

    @Override
    public void init(FilterConfig filterConfig) throws ServletException
    {
        String tempExcludes = filterConfig.getInitParameter("excludes");
        if (StringUtils.isNotEmpty(tempExcludes))
        {
            String[] url = tempExcludes.split(",");
            for (int i = 0; url != null && i < url.length; i++)
            {
                excludes.add(url[i]);
            }
        }
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException
    {
        HttpServletRequest req = (HttpServletRequest) request;
        HttpServletResponse resp = (HttpServletResponse) response;
        if (handleExcludeURL(req, resp))
        {
            chain.doFilter(request, response);
            return;
        }
        XssHttpServletRequestWrapper xssRequest = new XssHttpServletRequestWrapper((HttpServletRequest) request);
        chain.doFilter(xssRequest, response);
    }

    private boolean handleExcludeURL(HttpServletRequest request, HttpServletResponse response)
    {
        String url = request.getServletPath();
        String method = request.getMethod();
        // GET DELETE 不过滤
        if (method == null || HttpMethod.GET.matches(method) || HttpMethod.DELETE.matches(method))
        {
            return true;
        }
        return StringUtils.matches(url, excludes);
    }
}

在wrapper里过滤参数 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
public class XssHttpServletRequestWrapper extends HttpServletRequestWrapper
{
    /**
     * @param request
     */
    public XssHttpServletRequestWrapper(HttpServletRequest request)
    {
        super(request);
    }

    @Override
    public String[] getParameterValues(String name)
    {
        String[] values = super.getParameterValues(name);
        if (values != null)
        {
            int length = values.length;
            String[] escapesValues = new String[length];
            for (int i = 0; i < length; i++)
            {
                // 防xss攻击和过滤前后空格
                escapesValues[i] = EscapeUtil.clean(values[i]).trim();
            }
            return escapesValues;
        }
        return super.getParameterValues(name);
    }

    @Override
    public ServletInputStream getInputStream() throws IOException
    {
        // 非json类型，直接返回
        if (!isJsonRequest())
        {
            return super.getInputStream();
        }

        // 为空，直接返回
        String json = IOUtils.toString(super.getInputStream(), "utf-8");
        if (StringUtils.isEmpty(json))
        {
            return super.getInputStream();
        }

        // xss过滤
        json = EscapeUtil.clean(json).trim();
        byte[] jsonBytes = json.getBytes("utf-8");
        final ByteArrayInputStream bis = new ByteArrayInputStream(jsonBytes);
        return new ServletInputStream()
        {
            @Override
            public boolean isFinished()
            {
                return true;
            }

            @Override
            public boolean isReady()
            {
                return true;
            }

            @Override
            public int available() throws IOException
            {
                return jsonBytes.length;
            }

            @Override
            public void setReadListener(ReadListener readListener)
            {
            }

            @Override
            public int read() throws IOException
            {
                return bis.read();
            }
        };
    }

    /**
     * 是否是Json请求
     * 
     * @param request
     */
    public boolean isJsonRequest()
    {
        String header = super.getHeader(HttpHeaders.CONTENT_TYPE);
        return StringUtils.startsWithIgnoreCase(header, MediaType.APPLICATION_JSON_VALUE);
    }
}

xssUtil

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
public class EscapeUtil
{
    public static final String RE_HTML_MARK = "(<[^<]*?>)|(<[\\s]*?/[^<]*?>)|(<[^<]*?/[\\s]*?>)";

    private static final char[][] TEXT = new char[64][];

    static
    {
        for (int i = 0; i < 64; i++)
        {
            TEXT[i] = new char[] { (char) i };
        }

        // special HTML characters
        TEXT['\''] = "&#039;".toCharArray(); // 单引号
        TEXT['"'] = "&#34;".toCharArray(); // 双引号
        TEXT['&'] = "&#38;".toCharArray(); // &符
        TEXT['<'] = "&#60;".toCharArray(); // 小于号
        TEXT['>'] = "&#62;".toCharArray(); // 大于号
    }

    /**
     * 转义文本中的HTML字符为安全的字符
     * 
     * @param text 被转义的文本
     * @return 转义后的文本
     */
    public static String escape(String text)
    {
        return encode(text);
    }

    /**
     * 还原被转义的HTML特殊字符
     * 
     * @param content 包含转义符的HTML内容
     * @return 转换后的字符串
     */
    public static String unescape(String content)
    {
        return decode(content);
    }

    /**
     * 清除所有HTML标签，但是不删除标签内的内容
     * 
     * @param content 文本
     * @return 清除标签后的文本
     */
    public static String clean(String content)
    {
        return new HTMLFilter().filter(content);
    }

    /**
     * Escape编码
     * 
     * @param text 被编码的文本
     * @return 编码后的字符
     */
    private static String encode(String text)
    {
        if (StringUtils.isEmpty(text))
        {
            return StringUtils.EMPTY;
        }

        final StringBuilder tmp = new StringBuilder(text.length() * 6);
        char c;
        for (int i = 0; i < text.length(); i++)
        {
            c = text.charAt(i);
            if (c < 256)
            {
                tmp.append("%");
                if (c < 16)
                {
                    tmp.append("0");
                }
                tmp.append(Integer.toString(c, 16));
            }
            else
            {
                tmp.append("%u");
                if (c <= 0xfff)
                {
                    // issue#I49JU8@Gitee
                    tmp.append("0");
                }
                tmp.append(Integer.toString(c, 16));
            }
        }
        return tmp.toString();
    }

    /**
     * Escape解码
     * 
     * @param content 被转义的内容
     * @return 解码后的字符串
     */
    public static String decode(String content)
    {
        if (StringUtils.isEmpty(content))
        {
            return content;
        }

        StringBuilder tmp = new StringBuilder(content.length());
        int lastPos = 0, pos = 0;
        char ch;
        while (lastPos < content.length())
        {
            pos = content.indexOf("%", lastPos);
            if (pos == lastPos)
            {
                if (content.charAt(pos + 1) == 'u')
                {
                    ch = (char) Integer.parseInt(content.substring(pos + 2, pos + 6), 16);
                    tmp.append(ch);
                    lastPos = pos + 6;
                }
                else
                {
                    ch = (char) Integer.parseInt(content.substring(pos + 1, pos + 3), 16);
                    tmp.append(ch);
                    lastPos = pos + 3;
                }
            }
            else
            {
                if (pos == -1)
                {
                    tmp.append(content.substring(lastPos));
                    lastPos = content.length();
                }
                else
                {
                    tmp.append(content.substring(lastPos, pos));
                    lastPos = pos;
                }
            }
        }
        return tmp.toString();
    }
}


public final class HTMLFilter
{
   /**
    * regex flag union representing /si modifiers in php
    **/
   private static final int REGEX_FLAGS_SI = Pattern.CASE_INSENSITIVE | Pattern.DOTALL;
   private static final Pattern P_COMMENTS = Pattern.compile("<!--(.*?)-->", Pattern.DOTALL);
   private static final Pattern P_COMMENT = Pattern.compile("^!--(.*)--$", REGEX_FLAGS_SI);
   private static final Pattern P_TAGS = Pattern.compile("<(.*?)>", Pattern.DOTALL);
   private static final Pattern P_END_TAG = Pattern.compile("^/([a-z0-9]+)", REGEX_FLAGS_SI);
   private static final Pattern P_START_TAG = Pattern.compile("^([a-z0-9]+)(.*?)(/?)$", REGEX_FLAGS_SI);
   private static final Pattern P_QUOTED_ATTRIBUTES = Pattern.compile("([a-z0-9]+)=([\"'])(.*?)\\2", REGEX_FLAGS_SI);
   private static final Pattern P_UNQUOTED_ATTRIBUTES = Pattern.compile("([a-z0-9]+)(=)([^\"\\s']+)", REGEX_FLAGS_SI);
   private static final Pattern P_PROTOCOL = Pattern.compile("^([^:]+):", REGEX_FLAGS_SI);
   private static final Pattern P_ENTITY = Pattern.compile("&#(\\d+);?");
   private static final Pattern P_ENTITY_UNICODE = Pattern.compile("&#x([0-9a-f]+);?");
   private static final Pattern P_ENCODE = Pattern.compile("%([0-9a-f]{2});?");
   private static final Pattern P_VALID_ENTITIES = Pattern.compile("&([^&;]*)(?=(;|&|$))");
   private static final Pattern P_VALID_QUOTES = Pattern.compile("(>|^)([^<]+?)(<|$)", Pattern.DOTALL);
   private static final Pattern P_END_ARROW = Pattern.compile("^>");
   private static final Pattern P_BODY_TO_END = Pattern.compile("<([^>]*?)(?=<|$)");
   private static final Pattern P_XML_CONTENT = Pattern.compile("(^|>)([^<]*?)(?=>)");
   private static final Pattern P_STRAY_LEFT_ARROW = Pattern.compile("<([^>]*?)(?=<|$)");
   private static final Pattern P_STRAY_RIGHT_ARROW = Pattern.compile("(^|>)([^<]*?)(?=>)");
   private static final Pattern P_AMP = Pattern.compile("&");
   private static final Pattern P_QUOTE = Pattern.compile("\"");
   private static final Pattern P_LEFT_ARROW = Pattern.compile("<");
   private static final Pattern P_RIGHT_ARROW = Pattern.compile(">");
   private static final Pattern P_BOTH_ARROWS = Pattern.compile("<>");

   // @xxx could grow large... maybe use sesat's ReferenceMap
   private static final ConcurrentMap<String, Pattern> P_REMOVE_PAIR_BLANKS = new ConcurrentHashMap<>();
   private static final ConcurrentMap<String, Pattern> P_REMOVE_SELF_BLANKS = new ConcurrentHashMap<>();

   /**
    * set of allowed html elements, along with allowed attributes for each element
    **/
   private final Map<String, List<String>> vAllowed;
   /**
    * counts of open tags for each (allowable) html element
    **/
   private final Map<String, Integer> vTagCounts = new HashMap<>();

   /**
    * html elements which must always be self-closing (e.g. "<img />")
    **/
   private final String[] vSelfClosingTags;
   /**
    * html elements which must always have separate opening and closing tags (e.g. "<b></b>")
    **/
   private final String[] vNeedClosingTags;
   /**
    * set of disallowed html elements
    **/
   private final String[] vDisallowed;
   /**
    * attributes which should be checked for valid protocols
    **/
   private final String[] vProtocolAtts;
   /**
    * allowed protocols
    **/
   private final String[] vAllowedProtocols;
   /**
    * tags which should be removed if they contain no content (e.g. "<b></b>" or "<b />")
    **/
   private final String[] vRemoveBlanks;
   /**
    * entities allowed within html markup
    **/
   private final String[] vAllowedEntities;
   /**
    * flag determining whether comments are allowed in input String.
    */
   private final boolean stripComment;
   private final boolean encodeQuotes;
   /**
    * flag determining whether to try to make tags when presented with "unbalanced" angle brackets (e.g. "<b text </b>"
    * becomes "<b> text </b>"). If set to false, unbalanced angle brackets will be html escaped.
    */
   private final boolean alwaysMakeTags;

   /**
    * Default constructor.
    */
   public HTMLFilter()
   {
      vAllowed = new HashMap<>();

      final ArrayList<String> a_atts = new ArrayList<>();
      a_atts.add("href");
      a_atts.add("target");
      vAllowed.put("a", a_atts);

      final ArrayList<String> img_atts = new ArrayList<>();
      img_atts.add("src");
      img_atts.add("width");
      img_atts.add("height");
      img_atts.add("alt");
      vAllowed.put("img", img_atts);

      final ArrayList<String> no_atts = new ArrayList<>();
      vAllowed.put("b", no_atts);
      vAllowed.put("strong", no_atts);
      vAllowed.put("i", no_atts);
      vAllowed.put("em", no_atts);

      vSelfClosingTags = new String[] { "img" };
      vNeedClosingTags = new String[] { "a", "b", "strong", "i", "em" };
      vDisallowed = new String[] {};
      vAllowedProtocols = new String[] { "http", "mailto", "https" }; // no ftp.
      vProtocolAtts = new String[] { "src", "href" };
      vRemoveBlanks = new String[] { "a", "b", "strong", "i", "em" };
      vAllowedEntities = new String[] { "amp", "gt", "lt", "quot" };
      stripComment = true;
      encodeQuotes = true;
      alwaysMakeTags = false;
   }

   /**
    * Map-parameter configurable constructor.
    *
    * @param conf map containing configuration. keys match field names.
    */
   @SuppressWarnings("unchecked")
   public HTMLFilter(final Map<String, Object> conf)
   {

      assert conf.containsKey("vAllowed") : "configuration requires vAllowed";
      assert conf.containsKey("vSelfClosingTags") : "configuration requires vSelfClosingTags";
      assert conf.containsKey("vNeedClosingTags") : "configuration requires vNeedClosingTags";
      assert conf.containsKey("vDisallowed") : "configuration requires vDisallowed";
      assert conf.containsKey("vAllowedProtocols") : "configuration requires vAllowedProtocols";
      assert conf.containsKey("vProtocolAtts") : "configuration requires vProtocolAtts";
      assert conf.containsKey("vRemoveBlanks") : "configuration requires vRemoveBlanks";
      assert conf.containsKey("vAllowedEntities") : "configuration requires vAllowedEntities";

      vAllowed = Collections.unmodifiableMap((HashMap<String, List<String>>) conf.get("vAllowed"));
      vSelfClosingTags = (String[]) conf.get("vSelfClosingTags");
      vNeedClosingTags = (String[]) conf.get("vNeedClosingTags");
      vDisallowed = (String[]) conf.get("vDisallowed");
      vAllowedProtocols = (String[]) conf.get("vAllowedProtocols");
      vProtocolAtts = (String[]) conf.get("vProtocolAtts");
      vRemoveBlanks = (String[]) conf.get("vRemoveBlanks");
      vAllowedEntities = (String[]) conf.get("vAllowedEntities");
      stripComment = conf.containsKey("stripComment") ? (Boolean) conf.get("stripComment") : true;
      encodeQuotes = conf.containsKey("encodeQuotes") ? (Boolean) conf.get("encodeQuotes") : true;
      alwaysMakeTags = conf.containsKey("alwaysMakeTags") ? (Boolean) conf.get("alwaysMakeTags") : true;
   }

   private void reset()
   {
      vTagCounts.clear();
   }

   // ---------------------------------------------------------------
   // my versions of some PHP library functions
   public static String chr(final int decimal)
   {
      return String.valueOf((char) decimal);
   }

   public static String htmlSpecialChars(final String s)
   {
      String result = s;
      result = regexReplace(P_AMP, "&amp;", result);
      result = regexReplace(P_QUOTE, "&quot;", result);
      result = regexReplace(P_LEFT_ARROW, "&lt;", result);
      result = regexReplace(P_RIGHT_ARROW, "&gt;", result);
      return result;
   }

   // ---------------------------------------------------------------

   /**
    * given a user submitted input String, filter out any invalid or restricted html.
    *
    * @param input text (i.e. submitted by a user) than may contain html
    * @return "clean" version of input, with only valid, whitelisted html elements allowed
    */
   public String filter(final String input)
   {
      reset();
      String s = input;

      s = escapeComments(s);

      s = balanceHTML(s);

      s = checkTags(s);

      s = processRemoveBlanks(s);

      // s = validateEntities(s);

      return s;
   }

   public boolean isAlwaysMakeTags()
   {
      return alwaysMakeTags;
   }

   public boolean isStripComments()
   {
      return stripComment;
   }

   private String escapeComments(final String s)
   {
      final Matcher m = P_COMMENTS.matcher(s);
      final StringBuffer buf = new StringBuffer();
      if (m.find())
      {
         final String match = m.group(1); // (.*?)
         m.appendReplacement(buf, Matcher.quoteReplacement("<!--" + htmlSpecialChars(match) + "-->"));
      }
      m.appendTail(buf);

      return buf.toString();
   }

   private String balanceHTML(String s)
   {
      if (alwaysMakeTags)
      {
         //
         // try and form html
         //
         s = regexReplace(P_END_ARROW, "", s);
         // 不追加结束标签
         s = regexReplace(P_BODY_TO_END, "<$1>", s);
         s = regexReplace(P_XML_CONTENT, "$1<$2", s);

      }
      else
      {
         //
         // escape stray brackets
         //
         s = regexReplace(P_STRAY_LEFT_ARROW, "&lt;$1", s);
         s = regexReplace(P_STRAY_RIGHT_ARROW, "$1$2&gt;<", s);

         //
         // the last regexp causes '<>' entities to appear
         // (we need to do a lookahead assertion so that the last bracket can
         // be used in the next pass of the regexp)
         //
         s = regexReplace(P_BOTH_ARROWS, "", s);
      }

      return s;
   }

   private String checkTags(String s)
   {
      Matcher m = P_TAGS.matcher(s);

      final StringBuffer buf = new StringBuffer();
      while (m.find())
      {
         String replaceStr = m.group(1);
         replaceStr = processTag(replaceStr);
         m.appendReplacement(buf, Matcher.quoteReplacement(replaceStr));
      }
      m.appendTail(buf);

      // these get tallied in processTag
      // (remember to reset before subsequent calls to filter method)
      final StringBuilder sBuilder = new StringBuilder(buf.toString());
      for (String key : vTagCounts.keySet())
      {
         for (int ii = 0; ii < vTagCounts.get(key); ii++)
         {
            sBuilder.append("</").append(key).append(">");
         }
      }
      s = sBuilder.toString();

      return s;
   }

   private String processRemoveBlanks(final String s)
   {
      String result = s;
      for (String tag : vRemoveBlanks)
      {
         if (!P_REMOVE_PAIR_BLANKS.containsKey(tag))
         {
            P_REMOVE_PAIR_BLANKS.putIfAbsent(tag, Pattern.compile("<" + tag + "(\\s[^>]*)?></" + tag + ">"));
         }
         result = regexReplace(P_REMOVE_PAIR_BLANKS.get(tag), "", result);
         if (!P_REMOVE_SELF_BLANKS.containsKey(tag))
         {
            P_REMOVE_SELF_BLANKS.putIfAbsent(tag, Pattern.compile("<" + tag + "(\\s[^>]*)?/>"));
         }
         result = regexReplace(P_REMOVE_SELF_BLANKS.get(tag), "", result);
      }

      return result;
   }

   private static String regexReplace(final Pattern regex_pattern, final String replacement, final String s)
   {
      Matcher m = regex_pattern.matcher(s);
      return m.replaceAll(replacement);
   }

   private String processTag(final String s)
   {
      // ending tags
      Matcher m = P_END_TAG.matcher(s);
      if (m.find())
      {
         final String name = m.group(1).toLowerCase();
         if (allowed(name))
         {
            if (!inArray(name, vSelfClosingTags))
            {
               if (vTagCounts.containsKey(name))
               {
                  vTagCounts.put(name, vTagCounts.get(name) - 1);
                  return "</" + name + ">";
               }
            }
         }
      }

      // starting tags
      m = P_START_TAG.matcher(s);
      if (m.find())
      {
         final String name = m.group(1).toLowerCase();
         final String body = m.group(2);
         String ending = m.group(3);

         // debug( "in a starting tag, name='" + name + "'; body='" + body + "'; ending='" + ending + "'" );
         if (allowed(name))
         {
            final StringBuilder params = new StringBuilder();

            final Matcher m2 = P_QUOTED_ATTRIBUTES.matcher(body);
            final Matcher m3 = P_UNQUOTED_ATTRIBUTES.matcher(body);
            final List<String> paramNames = new ArrayList<>();
            final List<String> paramValues = new ArrayList<>();
            while (m2.find())
            {
               paramNames.add(m2.group(1)); // ([a-z0-9]+)
               paramValues.add(m2.group(3)); // (.*?)
            }
            while (m3.find())
            {
               paramNames.add(m3.group(1)); // ([a-z0-9]+)
               paramValues.add(m3.group(3)); // ([^\"\\s']+)
            }

            String paramName, paramValue;
            for (int ii = 0; ii < paramNames.size(); ii++)
            {
               paramName = paramNames.get(ii).toLowerCase();
               paramValue = paramValues.get(ii);

               // debug( "paramName='" + paramName + "'" );
               // debug( "paramValue='" + paramValue + "'" );
               // debug( "allowed? " + vAllowed.get( name ).contains( paramName ) );

               if (allowedAttribute(name, paramName))
               {
                  if (inArray(paramName, vProtocolAtts))
                  {
                     paramValue = processParamProtocol(paramValue);
                  }
                  params.append(' ').append(paramName).append("=\\\"").append(paramValue).append("\\\"");
               }
            }

            if (inArray(name, vSelfClosingTags))
            {
               ending = " /";
            }

            if (inArray(name, vNeedClosingTags))
            {
               ending = "";
            }

            if (ending == null || ending.length() < 1)
            {
               if (vTagCounts.containsKey(name))
               {
                  vTagCounts.put(name, vTagCounts.get(name) + 1);
               }
               else
               {
                  vTagCounts.put(name, 1);
               }
            }
            else
            {
               ending = " /";
            }
            return "<" + name + params + ending + ">";
         }
         else
         {
            return "";
         }
      }

      // comments
      m = P_COMMENT.matcher(s);
      if (!stripComment && m.find())
      {
         return "<" + m.group() + ">";
      }

      return "";
   }

   private String processParamProtocol(String s)
   {
      s = decodeEntities(s);
      final Matcher m = P_PROTOCOL.matcher(s);
      if (m.find())
      {
         final String protocol = m.group(1);
         if (!inArray(protocol, vAllowedProtocols))
         {
            // bad protocol, turn into local anchor link instead
            s = "#" + s.substring(protocol.length() + 1);
            if (s.startsWith("#//"))
            {
               s = "#" + s.substring(3);
            }
         }
      }

      return s;
   }

   private String decodeEntities(String s)
   {
      StringBuffer buf = new StringBuffer();

      Matcher m = P_ENTITY.matcher(s);
      while (m.find())
      {
         final String match = m.group(1);
         final int decimal = Integer.decode(match).intValue();
         m.appendReplacement(buf, Matcher.quoteReplacement(chr(decimal)));
      }
      m.appendTail(buf);
      s = buf.toString();

      buf = new StringBuffer();
      m = P_ENTITY_UNICODE.matcher(s);
      while (m.find())
      {
         final String match = m.group(1);
         final int decimal = Integer.valueOf(match, 16).intValue();
         m.appendReplacement(buf, Matcher.quoteReplacement(chr(decimal)));
      }
      m.appendTail(buf);
      s = buf.toString();

      buf = new StringBuffer();
      m = P_ENCODE.matcher(s);
      while (m.find())
      {
         final String match = m.group(1);
         final int decimal = Integer.valueOf(match, 16).intValue();
         m.appendReplacement(buf, Matcher.quoteReplacement(chr(decimal)));
      }
      m.appendTail(buf);
      s = buf.toString();

      s = validateEntities(s);
      return s;
   }

   private String validateEntities(final String s)
   {
      StringBuffer buf = new StringBuffer();

      // validate entities throughout the string
      Matcher m = P_VALID_ENTITIES.matcher(s);
      while (m.find())
      {
         final String one = m.group(1); // ([^&;]*)
         final String two = m.group(2); // (?=(;|&|$))
         m.appendReplacement(buf, Matcher.quoteReplacement(checkEntity(one, two)));
      }
      m.appendTail(buf);

      return encodeQuotes(buf.toString());
   }

   private String encodeQuotes(final String s)
   {
      if (encodeQuotes)
      {
         StringBuffer buf = new StringBuffer();
         Matcher m = P_VALID_QUOTES.matcher(s);
         while (m.find())
         {
            final String one = m.group(1); // (>|^)
            final String two = m.group(2); // ([^<]+?)
            final String three = m.group(3); // (<|$)
            // 不替换双引号为&quot;，防止json格式无效 regexReplace(P_QUOTE, "&quot;", two)
            m.appendReplacement(buf, Matcher.quoteReplacement(one + two + three));
         }
         m.appendTail(buf);
         return buf.toString();
      }
      else
      {
         return s;
      }
   }

   private String checkEntity(final String preamble, final String term)
   {

      return ";".equals(term) && isValidEntity(preamble) ? '&' + preamble : "&amp;" + preamble;
   }

   private boolean isValidEntity(final String entity)
   {
      return inArray(entity, vAllowedEntities);
   }

   private static boolean inArray(final String s, final String[] array)
   {
      for (String item : array)
      {
         if (item != null && item.equals(s))
         {
            return true;
         }
      }
      return false;
   }

   private boolean allowed(final String name)
   {
      return (vAllowed.isEmpty() || vAllowed.containsKey(name)) && !inArray(name, vDisallowed);
   }

   private boolean allowedAttribute(final String name, final String paramName)
   {
      return allowed(name) && (vAllowed.isEmpty() || vAllowed.get(name).contains(paramName));
   }
}

前后端组合使用，可解决xss问题

安全无小事！！！

存储型XSS漏洞解决方案

]]> + + + + + 安全 + + + + + + + spring + + 安全 + + + + + + + + + 网站任意文件下载或读取 + + /2023/06/20/safe-http-any-file-download/ + + 项目中下载方法没有安全校验，导致脚本注入，可以下载服务器任意路径下的文件。
对此总结了一下修复办法，方便大家参考，修复。

以下是漏洞的一些内容：

安全漏洞描述

任意文件下载或读取漏洞主要是由于应用系统在提供文件下载或读取功能时，在文件路径参数中直接指定文件路径的同时并没有对文件路径的合法性进行校验，
导致攻击者可通过目录跳转(..\或../)的方式下载或读取到原始指定路径之外的文件。
攻击者最终可通过该漏洞下载或读取系统上的任意文件，如数据库文件、应用系统源代码、密码配置信息等重要敏感信息，造成系统的敏感信息泄露。

重现方法

对存在文件下载或文件读取功能的页面进行测试，查看所提交的参数中是否包含文件名或文件目录，尝试提交参数值查看是否可下载或读取其他目录的文件内容；

如：

原始下载功能路径为
http://www.example.com/donwload.jsp?filename=test123456789.pdf

其中文件路径参数为filename，通过../对路径进行跳转尝试下载其他目录下的文件，修改filename参数为../../WEB-INF/web.xml尝试下载JSP网站的配置文件（测试过程中需适当增加../跳转字符串）；如提交
http://www.example.com/donwload.jsp?filename=../../WEB-INF/web.xml

查看是否成功下载web.xml文件。

另一种情况如下：
http://www.example.com/donwload.jsp?filepath=uploadfile&filename=test123.pdf
该功能通过filepath以及filename指定下载目录以及下载文件名，可修改filepath参数值进行路径跳转，
同时修改filename值指定文件名；如提交
http://www.example.com/donwload.jsp?filepath=../../WEB-INF&filename=web.xml

查看是否成功下载web.xml文件。

风险等级：高

解决办法

知道了问题，一般可以通过在代码层级增加关键字符过滤来修复。
比如：

  1. 对path参数进行过滤，依次过滤“.”、“..”、“/”、“”等字符。
  2. 或者对于下载文件的目录做好限制，只能下载指定目录下的文件，
  3. 或者将要下载的资源文件路径存入数据库，附件下载时指定数据库中的id即可，id即对应的资源。
    服务器级建议
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
private Pair<Boolean,String> checkFileAttack(String filePath) {
    if (StringUtils.isEmpty(filePath)) {
        return Pair.of(false, "文件名为空");
    }

    if (filePath.startsWith("/")) {
        return Pair.of(false, "文件名不能以/开始");
    }

    // 禁止文件名中包含  “%00”，“..”，“./”，“#/” ，"~/" , "^/"    Pattern pattern = Pattern.compile("(\\.\\.|~/|^/|\\./|#/|%00)");
    if (pattern.matcher(filePath).matches()) {
        return Pair.of(false, "文件名不合法");
    }

    if (!ArrayUtils.contains(MimeTypeUtils.DEFAULT_ALLOWED_EXTENSION, FileTypeUtils.getFileType(filePath)))
    {
        return Pair.of(false, "非法格式");
    }

    return Pair.of(true, "校验成功");
}

或者，在服务部署的时候，通过下面的目录固化部署路径，令web请求不能逃逸到整个服务器。

  • 使用chroot 命令，固化服务路径

安全无小事！！！

]]> + + + + + 安全 + + + + + + + spring + + 安全 + + + + + + + + + URL存在http host头攻击漏洞的解决办法 + + /2023/06/20/safe-http-url-header-attack/ + + 项目中遇到http host头攻击的解决办法，支持nginx，apache 两种办法。

以下是漏洞的一些内容：

安全漏洞描述

为了方便的获得网站域名，开发人员一般依赖于HTTP Host header。例如，在php里用_SERVER[“HTTP_HOST”]。
但是这个header是不可信赖的，如果应用程序没有对host header值进行处理，就有可能造成恶意代码的传入。

http-host-attack

风险等级：高

解决办法

web应用程序应该使用SERVER_NAME而不是host header。 在Apache和Nginx里可以通过设置一个虚拟机来记录所有的非法host header。
在Nginx里还可以通过指定一个SERVER_NAME名单，Apache也可以通过指定一个SERVER_NAME名单并开启UseCanonicalName选项。

本质上就是在服务侧鉴定请求来源， 非法来源直接过滤掉。

nginx 解决方案

打开nginx的网站配置文件，一般为 /etc/nginx/conf.d/xxx.conf
添加如下配置

1
2
3
4
5
6
7
8
9
server {
    listen       80;
    server_name  127.0.0.1;
    # 防止http host 攻击的配置： 仅允许 指定域名访问，其他域名返回403
    if ($http_Host !~* ^domain.com|127.0.0.1:80$) {
        return 403;
    }
    # 其他配置
}

重启nginx即可

1
nginx -s reload

Apache解决方案

打开Apache的配置 ， 一般为 /conf/httpd.conf
添加如下配置：

1
2
3
4
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www.domain.com$ [NC]
RewriteRule ^(.*)$ /403.html

重启apache即可

安全无小事！！！

Web漏洞之HOST头攻击

host头攻击

]]> + + + + + 安全 + + + + + + + nginx + + 安全 + + apache + + + + + + + + + 中间件版本号泄露问题修复 + + /2023/06/19/safe-dev-info-leak/ + + 开发过程中的一些信息带到了线上，要及时修复，不如坏人就顺藤摸瓜找来了。

以下是漏洞的一些内容：

安全漏洞描述

信息泄露主要是由于开发人员或运维管理人员的疏忽所导致。如未及时删除调试页面、未关闭程序调试功能、未屏蔽程序错误信息、备份文件未删除、数据库备份文件未删除、未屏蔽敏感数据信息等多个方面所导致的不同严重程度的信息泄露。攻击者可通过所掌握的信息进一步分析攻击目标，从而有效发起下一步的有效攻击。

常见的问题有：

  1. swagger 接口未关闭
  2. druid监控台未关闭
  3. 等

风险等级：低

解决办法

关闭相关接口的线上权限，或增加权限控制

1，swagger 关闭入口的方式
方法a: 使用注解 @Value() 推荐使用， 然后在不同的配置文件里指定开关

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
@Value("${swagger.enabled}")
private boolean enabled;

@Bean
public Docket createRestApi()
{
    return new Docket(DocumentationType.V1)
            // 是否启用Swagger           
             .enable(enabled)
            // 用来创建该API的基本信息，展示在文档的页面中（自定义展示的信息）            
            .apiInfo(apiInfo())
            // 设置哪些接口暴露给Swagger展示           
             .select()
            // 扫描所有有注解的api，用这种方式更灵活           
             .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
            // 扫描指定包中的swagger注解            
            // .apis(RequestHandlerSelectors.basePackage("com.ruoyi.project.tool.swagger"))           
             // 扫描所有 .apis(RequestHandlerSelectors.any())            
             .paths(PathSelectors.any())
            .build()
            /* 设置安全模式，swagger可以设置访问token */          
            .securitySchemes(securitySchemes())
            .securityContexts(securityContexts())
            .pathMapping(pathMapping);
}

方法b: 使用注解@Profile({“dev”,“test”}) 表示在开发或测试环境开启，而在生产关闭
swagger-switch
其实ab 的方式是一样的，都是不同的环境开关不同。

2， druid关闭监控台的方式

1
2
spring.datasource.druid.webStatFilter.enabled=false
spring.datasource.druid.statViewServlet.enabled=false

3， 一些其他接口增加权限认证
通过spring的httpSecurity 增加路径鉴权

1
2
3
4
5
6
protected void configure(HttpSecurity httpSecurity) throws Exception {
    // something
    // druid 接口要鉴权
    httpSecurity..antMatchers("/druid/**").authenticated()
    // something
}

安全无小事！！！

]]> + + + + + 安全 + + + + + + + spring + + 安全 + + + + + + + + + AntPathMatcher VS PathPattern + + /2023/05/21/spring-spring-path-matcher/ + + spring路径匹配，在spring5以后，有了AntPathMatcher 和 PathPattern 两种方式。

PathPattern是在spring 5 以后新增的。本文就介绍 AntPathMatcher 和 PathPattern 的异同，以及这两者的使用场景和方式。

创建实例

AntPathMatcher在1.x版本就存在了，在spring5以前，一直作为spring的路径匹配器存在。

AntPathMatcher在spring中是作为工具类存在的，所以直接new对象即可。

PathPattern出现在spring5.x版本中, 旨在用于替换掉较为“古老”的AntPathMatcher。

PathPattern是spring一个内部类，不能通过public的方式来创建。不过spring 官方提供了一个parser开提供PathPattern的默认实例。

1
2
3
4
// 构建AntPathMatcher 实例
AntPathMatcher antPathMatcher = new AntPathMatcher();
// 构建PathPattern 实例
PathPatternParser patternParser = PathPatternParser.defaultInstance;

匹配规则

AntPathMatcher 官方文档：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
映射使用以下规则匹配 URL： 
? 匹配一个字符
* 匹配零个或多个字符
** 匹配路径中的零 个 或多个目录
{spring:[a-z]+} 将正则表达 [a-z]+ 式匹配为名为“spring”的路径变量
        
例子
com/t?st.jsp — 匹配 com/test.jsp ，但也 com/tast.jsp 匹配或 com/txst.jsp
com/*.jsp— 匹配目录中com的所有.jsp文件
com/**/test.jsp— 匹配路径下com的所有test.jsp文件
org/springframework/**/*.jsp— 匹配路径下org/springframework的所有.jsp文件
org/**/servlet/bla.jsp — 匹配 org/springframework/servlet/bla.jsp ，但也 org/springframework/testing/servlet/bla.jsp 和 org/servlet/bla.jsp
com/{filename:\\w+}.jsp将匹配com/test.jsp该值testfilename并将其分配给变量
注意： 模式和路径必须都是绝对的，或者必须都是相对的，才能使两者匹配。因此，建议此实现的用户清理模式，以便在使用模式的上下文中为“/”作为前缀。

PathPattern 官方文档

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
PathPattern 使用以下规则匹配 URL 路径： 
? 匹配一个字符
* 匹配路径段中的零个或多个字符
** 匹配零个或多个 路径段 ，直到路径结束
{spring} 匹配 路径段 并将其捕获为名为“spring”的变量
{spring:[a-z]+} 将正则表达 [a-z]+ 式匹配为名为“spring”的路径变量
{*spring} 匹配零个或多个 路径段 ，直到路径的末尾，并将其捕获为名为“spring”的变量
注意： 与 org.springframework.util.AntPathMatcher相反， ** 仅在模式的末尾受支持。例如 /pages/{**} ，是有效的，但不是 /pages/{**}/details 。这同样适用于捕获变体 {*spring}。目的是在比较模式的特异性时消除歧义。

例子
/pages/t?st.html — 匹配 /pages/test.html ， /pages/tXst.html 但不是 /pages/toast.html
/resources/*.png— 匹配目录中resources的所有.png文件
/resources/** — 匹配路径下 /resources/ 的所有文件，包括 /resources/image.png 和 /resources/css/spring.css
/resources/{*path} — 匹配 和 下的所有文件 /resources/， /resources并在名为 “path” 的变量中捕获它们的相对路径; /resources/image.png 将与 “path” 匹配 → “/image.png”，并将 /resources/css/spring.css 与 “path” 匹配 → “/css/spring.css”
/resources/{filename:\\w+}.dat将匹配/resources/spring.dat该值"spring"filename并将其分配给变量

可见，AntPathMatcher 和 PathPattern 的匹配规则是差不多的，都支持? * ** 已经部分正则匹配。

但PathPattern增加了路径匹配并提取结果的能力，同时为了消除歧义，不再支持路径中间的**匹配，其他一样。

demo:

*匹配

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
public class TestPathMatch {
    public static void main(String[] args) {
        AntPathMatcher antPathMatcher = new AntPathMatcher();
        PathPatternParser patternParser = PathPatternParser.defaultInstance;

        List<String> list = List.of("aaa_1.csv", "aaa_2.csv", "aaa_3.csv", "aaa_1.xlsx", "aaa", "aaa.pdf");
        String pattern1 = "a*.csv";

        System.out.println("by antPathMatcher..");
        for (String s : list) {
            System.out.printf("pattern %s match %s is %s %n", pattern1,s, antPathMatcher.match(pattern1,s));
        }
        System.out.println("by patternParser..");
        for (String s : list) {
            System.out.printf("pattern %s match %s is %s %n", pattern1,s, patternParser.parse(pattern1).matches(PathContainer.parsePath(s)));
        }
    }
}

// 结果
// by antPathMatcher..
// pattern a*.csv match aaa_1.csv is true
// pattern a*.csv match aaa_2.csv is true
// pattern a*.csv match aaa_3.csv is true
// pattern a*.csv match aaa_1.xlsx is false
// pattern a*.csv match aaa is false
// pattern a*.csv match aaa.pdf is false
// by patternParser..
// pattern a*.csv match aaa_1.csv is true
// pattern a*.csv match aaa_2.csv is true
// pattern a*.csv match aaa_3.csv is true
// pattern a*.csv match aaa_1.xlsx is false
// pattern a*.csv match aaa is false
// pattern a*.csv match aaa.pdf is false

PathPattern 路径提取

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public class TestPathMatch {
    public static void main(String[] args) {
        AntPathMatcher antPathMatcher = new AntPathMatcher();
        PathPatternParser patternParser = PathPatternParser.defaultInstance;

        String pattern = "/api/hancher/{*spring}";
        List<String> list = List.of("/api/hancher/a/b/c", "/api/hancher/a", "/api/hancher/a/", "/api/hancher/a/b/c.csv","/api/test/a/b/c");

        for (String s : list) {
            System.out.printf("pattern %s match %s is %s %n", pattern,s, patternParser.parse(pattern).matches(PathContainer.parsePath(s)));
            System.out.printf("pattern %s match %s result %s %n", pattern,s, patternParser.parse(pattern).matchAndExtract(PathContainer.parsePath(s)));
        }
    }
}

// 结果
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c is true 
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c result PathMatchInfo[uriVariables={spring=/a/b/c}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/hancher/a is true 
//pattern /api/hancher/{*spring} match /api/hancher/a result PathMatchInfo[uriVariables={spring=/a}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/hancher/a/ is true 
//pattern /api/hancher/{*spring} match /api/hancher/a/ result PathMatchInfo[uriVariables={spring=/a/}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c.csv is true 
//pattern /api/hancher/{*spring} match /api/hancher/a/b/c.csv result PathMatchInfo[uriVariables={spring=/a/b/c.csv}, matrixVariables={}] 
//pattern /api/hancher/{*spring} match /api/test/a/b/c is false 
//pattern /api/hancher/{*spring} match /api/test/a/b/c result null

性能

官方说PathPattern 比 AntPathMatcher 更快一些，所以咱们验证一下：

测试代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public class TestPathMatch {
    public static void main(String[] args) {
        AntPathMatcher antPathMatcher = new AntPathMatcher();
        PathPatternParser patternParser = PathPatternParser.defaultInstance;

        long start = System.currentTimeMillis();
        String pattern = "/api/hanc?er/**";
        for (int i = 0; i < 100000; i++) {
            String path = "/api/hancher/" + i + "/" + i + "/a.txt";
            System.out.println(antPathMatcher.match(pattern, path));
//            System.out.println(patternParser.parse(pattern).matches(PathContainer.parsePath(path)));
        }
        System.out.println(System.currentTimeMillis() - start);
    }
}

分别跑了5次。
AntPathMatcher 平均耗时：392ms
PathPattern 平均耗时：323.4ms
官方所言不虚！

选择

  1. 在满足需求的情况下，尽量选PathPattern，更快
  2. 如果需要通过*匹配中间路径，或者通过匹配文件扩展名这种场景，用AntPathMatcher， 因为PathPattern不支持。
]]> + + + + + spring + + + + + + + spring + + + + + + + + + spring服务form表单内容过大导致后端参数接收为null情况 + + /2023/04/28/exception-spring-http-form-too-big-err/ + + 问题现状

今天开发遇到一个奇怪的问题，前端的form表单数据提交的时候，数据量比较小的时候，内容能正常保存。

当数据量达到1.6M的时候，后端就开始报npe异常，参数字段就开始接收不到了。

解决

经过排查，发现这个和编程无关。
springboot 默认集成了tomcat容器，tomcat对form表单的大小有限制，默认2M。

知道了问题所在，解决起来就很简单了。
方案1： 增加tomcat的form表单容量配置

1
server.tomcat.max-http-form-post-size=10MB

方案2：去掉tomcat的form容量配置

1
server.tomcat.max-http-form-post-size=-1

参考

spring官方配置

]]> + + + + + 编程人生 + + + + + + + java + + 异常 + + spring + + + + + + + + + 如何给bash脚本进行加密？ + + /2023/04/20/bash-shc/ + + 当我们写的bash脚本，有的时候需要分享给别人用，但是又不太想让别人看到实现逻辑。没到这个时候，就想着要是能给这个脚本加密一下就好了。
仅加密脚本的内容，又不影响脚本的运行，多好。要知道在计算机的世界，只有想不到，没有做不到！
你不是第一个遇到这个问题的人，而且有比你更有行动力的人把这个问题解决了。

今天我们就介绍两个工具来解决这个问题。

gzexe

mac系统上自带的一个工具，可以在mac系统上将一个可执行的bash脚本加密。
使用方式：

1
usage: gzexe [-d] file ...

我们以hello.sh 脚本为例。

1
2
#!/bin/bash
echo "Hello World "

操作：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
mac % gzexe hello.sh 
gzexe: cannot compress hello.sh, it is not executable # hello.sh 必须是一个可执行文件

# 修改hello.sh 为可执行文件
mac % chmod 744 hello.sh 

mac % gzexe hello.sh 
hello.sh:   -4.3%  

# 成功，并且体检压缩了4.3% 我们执行一下ls 看看发生了什么
mac % ls
hello.shhello.sh~

# 这个时候我们发现hello.sh已经加密了，但我们发现多了一个hello.sh~文件。 这个就是我们的加密前的源文件。
# 源文件还在？我们把hello.sh~删了 ， 看看还不能运行。
mac % rm hello.sh~
mac % sh hello.sh 
Hello World # 依然可以运行

但是我们把hello.sh放到其他系统上执行时，会发现失败。但是在mac本地系统执行时，还是可以的.

shc (Shell Script Compiler)

shell(bash) 脚本编译指令。mac系统原生不支持，可以通过下面方式安装。

安装步骤

  1. 检查本地是否装有shc， 直接输入shc命令
  2. 安装
1
2
3
4
5
# linux 
yum install shc

# mac
brew install shc

使用

使用方式：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mac % shc -h
shc Version 4.0.3, Generic Shell Script Compiler
shc GNU GPL Version 3 Md Jahidul Hamid <jahidulhamid@yahoo.com>
shc Usage: shc [-e date] [-m addr] [-i iopt] [-x cmnd] [-l lopt] [-o outfile] [-rvDSUHCABh] -f script

    -e %s  Expiration date in dd/mm/yyyy format [none]
    -m %s  Message to display upon expiration ["Please contact your provider"]
    -f %s  File name of the script to compile
    -i %s  Inline option for the shell interpreter i.e: -e
    -x %s  eXec command, as a printf format i.e: exec('%s',@ARGV);
    -l %s  Last shell option i.e: --
    -o %s  output filename
    -r     Relax security. Make a redistributable binary
    -v     Verbose compilation
    -S     Switch ON setuid for root callable programs [OFF]
    -D     Switch ON debug exec calls [OFF]
    -U     Make binary untraceable [no]
    -H     Hardening : extra security protection [no]
           Require bourne shell (sh) and parameters are not supported
    -C     Display license and exit
    -A     Display abstract and exit
    -B     Compile for busybox
    -h     Display help and exit

同样以hello.sh脚本为例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 普通加密
mac % shc -v -f hello.sh
mac % ls 
hello.sh # 原始脚本
hello.sh.x# 可执行脚本
hello.sh.x.c # 可执行脚本c语音文件

# 设置过期时间的加密脚本
mac % shc -v -e 20/04/2023 -m "过期了" -f hello.sh -o hello_expir.sh 
shc -e Thu Apr 20 00:00:00 2023
shc -e Thu Apr 20 00:00:00 2023
shc shll=bash
shc [-i]=-c
shc [-x]=exec '%s' "$@"
shc [-l]=
shc opts=
shc: cc   hello.sh.x.c -o hello_expir.sh
shc: strip hello_expir.sh
shc: chmod ug=rwx,o=rx hello_expir.sh

# 查看结果
mac % ls 
hello.shhello.sh.x.chello_expir.sh

# 过期效果
mac % ./hello_expir.sh 
./hello_expir.sh: has expired!
过期了

同gzexe一样，加密后的脚本一样不支持跨平台运行，即使是编译成c语言的二进制脚本。因为可执行文件会依赖不同系统的动态链接库。

参考

gzexe 源码

gzexe examples

SHC-Shell-Compiler

shc官网

]]> + + + + + linux + + + + + + + linux + + bash + + + + + + + + + JDK 20新特性简介 + + /2023/04/04/java-jdk-v20/ + + jdk20
按照JDK每半年发布一次版本的节奏, JDK20在2023年3月发布了, 本文就是简单介绍一下这次更新的新特性与改动.

一句话总结, 这仍然是jdk的一个短期支持版本,此版本包括7个 JEP（jdk增强建议），以及数百个较小的功能增强和数千个错误修复.

新特性汇总

预览特性

语言特性:

  • JEP 432 Record Patterns(记录模式) : 第2预览阶段. 记录模式是java语言的一个新语言特性.其目的是将我们从java复杂的类构造中解放出来,更关注于数据. 一般用于一组数据构成的一个整体,比如坐标point(x,y).
  • JEP 433 Pattern Matching for switch(switch记录模式):第4次预览, switch语法支持记录模式.

API库扩充:

  • JEP 434 Foreign Function &Memory AP(访问jvm外部函数或内存的API) : 引入一个API，通过该API，Java程序可以在Java运行时之外与代码和数据进行互操作。通过有效地调用外部函数（即JVM外部的代码），并通过安全访问外部内存（即不由JVM管理的内存），API使Java程序能够调用本机库并处理本机数据，而没有JNI的脆性和危险性。
  • JEP 438 Vector API(向量API): 第5孵化阶段.向量计算由对向量的一系列操作组成。向量 API 用来表达向量计算，该计算可以在运行时可靠地编译为支持的 CPU 架构上的最佳向量指令，从而实现优于等效标量计算的性能。向量 API 的目标是为用户提供简洁易用且与平台无关的表达范围广泛的向量计算.

并发增强:

  • JEP 429 Scoped Values(作用域值) : 孵化阶段.引入范围值，允许在线程内和线程之间共享不可变的数据。它们优于线程本地变量，特别是在使用大量虚拟线程时。因为变量是不可变的,也就避免了并发问题.
  • JEP 436 Virtual Threads(虚拟线程) : 第2预览阶段. 将虚拟线程引入Java平台。虚拟线程是轻量级线程，大大减少了编写、维护和观察高吞吐量并发应用程序的工作量. 本次主要是一些核心功能升级.
  • JEP 437 Structured Concurrency(结构化并发) : 第2孵化阶段. 通过引入结构化并发的API来简化多线程编程。结构化并发将在不同线程中运行的多个任务视为单个工作单元，从而简化错误处理和取消，提高可靠性并提高可观察性。

主要特性

核心库

  • Support Unicode 15.0 (JDK-8284842) : 支持Unicode15.0 .
  • Print Warning to Standard Error If Bad java.io.tmpdir Setting Is Detected (JDK-8290313) : 新增一种警告输出场景

安全

  • New JFR Event: jdk.InitialSecurityProperty (JDK-8292177) : 新增一个新的JFR(Java Flight Recorder)事件.
  • New JFR Event: jdk.SecurityProviderService (JDK-8254711) : 新增一个新的JFR(Java Flight Recorder)事件.
  • Provide Poly1305 Intrinsic on x86_64 platforms with AVX512 instructions (JDK-8288047) : 此功能在x86_64平台上使用AVX512指令为SunJCE提供商的Poly1305消息身份验证代码算法提供优化。
  • Provide ChaCha20 Intrinsics on x86_64 and aarch64 Platforms (JDK-8247645) : 此功能为SunJCE提供商提供的ChaCha20密码提供了优化的内在实现。这些优化的例程专为支持AVX、AVX2和/或AVX512指令集的x86_64芯片组以及支持高级SIMD指令集的aarch64芯片组而设计。
  • (D)TLS Key Exchange Named Groups (JDK-8281236) : 加密功能增强.
  • DTLS Resumption Uses HelloVerifyRequest Messages (JDK-8287411) : 加密功能增强.

工具

  • Javac Warns about Type Casts in Compound Assignments with Possible Lossy Conversions(JDK-8244681) : javac命令增加了有损类型强转警告.
  • New ‘jmod –compress’ Command Line Option(JDK-8293499) : 在jmod工具中添加了一个新的–compress命令行选项，以便在创建JMOD存档时指定压缩级别。接受的值是zip-[0-9]，其中zip-0不提供压缩，zip-9提供最佳压缩。默认是zip-6。

jdk20 工具箱全集
java-bin

虚拟机

  • add bean for Remark and Cleanup Pause Time in G1 (JDK-8297247) : G1垃圾回收在标记和清理阶段引入了一个新的回收bean : “G1 Concurrent GC”

移出功能

  • Thread.suspend/resume Changed to Throw UnsupportedOperationException (JDK-8249627) : 在此版本中，使用Thread.suspend()和Thread.resume()方法暂停或恢复线程的能力已被删除。方法已更改为抛出UnsupportedOperationException。这些方法本质上容易陷入僵局，自JDK 1.2（1998年）以来已被弃用。ThreadGroup中的相应方法，即暂停或恢复一组线程，已更改为在Java 19中抛出UnsupportedOperationException。
  • Thread.Stop Changed to Throw UnsupportedOperationException (JDK-8289610) : 在此版本中，使用Thread.stop()方法“停止”线程的功能已被删除。该方法已更改为抛出UnsupportedOperationException。通过使其抛出java.lang.ThreadDeath来阻止线程本质上是不安全的。自JDK 1.2（1998）以来，停止方法已被弃用。ThreadGroup中的相应方法“停止”一组线程，已更改为在Java 19中抛出UnsupportedOperationException。同时, java.lang.ThreadDeath也被标记为废弃.
  • Remove Support for javac -source/-target/–release 7 (JDK-8173605) : javac移出了一些选项
  • Improved Control of G1 Concurrent Refinement Threads (JDK-8137022): G1并发细化线程的控制已被完全取代。新控制器通常分配更少的线程。它在细化线程活动中的峰值往往较少。它还倾向于延迟细化，当对相同或附近位置有多个写入时，允许通过写入屏障进行更多过滤，从而提高屏障的效率。

废弃功能

  • java.net.URL Constructors Are Deprecated (JDK-8294241) : 废弃URL构造方法,推荐使用 java.net.URI 来构建URL.
  • Deprecate JMX Management Applets for Removal (DK-8297794) : 废弃JMX

小优化

这里主要介绍一些小的优化, 太长可以不看.

  • HTTP Response Input Streams Will Throw an IOException on Interrupt (JDK-8294047) : http请求中断抛出异常
  • HttpClient Default Keep Alive Time is 30 Seconds (JDK-8297030) : 由java.net.http.HttpClient创建的HTTP/1.1和HTTP/2连接的默认空闲连接超时值已从1200秒减少到30秒
  • Idle Connection Timeouts for HTTP/2 (JDK-8288717) : 此版本中添加了HTTP/2的空闲连接超时。
  • FileChannel Positional Write Is Unspecified in APPEND Mode (JDK-6924219) : append模式下,FileChannel写入位置因操作系统而定
  • Update Timezone Data to 2022c (JDK-8292579) : 此版本包括2022b的更改，将1970年后具有相同时间戳数据的多个区域合并到单个时区数据库中。所有时区ID保持不变，但合并的时区将指向共享区域数据库。
  • IdentityHashMap’s Remove and Replace Methods Use Object Identity (JDK-8178355) : IdentityHashMap的这两个方法, 对象比较由 equals 改为 ==
  • Support for CLDR Version 42 (JDK-8284840) : 基于Unicode Consortium的CLDR的本地数据已升级到版本42
  • Introduce LDAP and RMI Protocol Specific Object Factory Filters to JNDI Implementation (JDK-8290368) : 引入了新的系统和安全属性，以允许对允许从JNDI/LDAP和JNDI/RMI上下文重建Java对象的JNDI对象工厂集进行更精细的控制
  • G1: Disable Preventive GCs by Default (JDK-8293861) : G1默认禁用Preventive垃圾回收器
  • appendToClassPathForInstrumentation Must Be Used in a Thread-Safe Manner (JDK-8296472) : 如题, 当时用java agent时,自定义类加载器中的appendToClassPathForInstrumentation方法必须以线程安全的方式添加到类搜索路径中。
  • Deprecate and Disable Legacy Parallel Class Loading Workaround for Non-Parallel-Capable Class Loaders (JDK-8295673) : 一些用户定义的旧类加载器会通过在加载过程中释放类加载器锁来解决死锁问题。为了防止这些加载程序在通过并行线程加载同一类时遇到“java.lang.LinkageError：尝试重复类定义”，HotSpot虚拟机在JDK 6中引入了一种变通方法，将加载尝试序列化，导致随后的尝试等待第一个完成. 现在将这种变通 方法废弃了
  • Disabled DTLS 1.0 (JDK-8256660) : 废弃 DTLS 1.0
  • Remove Thread Text from Subject.current (JDK-8297276) : 在此版本中，Subject.current的规范已更改，以降低创建线程时继承主题的期望。此时，主题存储在AccessControlContext中，并在创建平台线程时被继承。虚拟线程在线程创建时不会捕获调用者上下文，并且不会继承AccessControlContext。在删除对SecurityManager和继承的AccessControlContext的支持之前，将在未来的版本中重新审查继承。
  • Generalize ‘see’ and ‘link’ Tags for User-Defined Anchors (JDK-8200337) : {@link}、{@linkplain}和@see标签已增强，允许链接到JavaDoc生成的元素文档中的任意锚点。为了区分这些引用和成员引用，使用双散列标记（##）将元素名称与URI片段分开。

名词解析

  • HarfBuzz: 一个开源的用于文字塑形的软件开发库，亦即用于转换Unicode文本到字形指标及方位的过程

  • FreeType: 同HarfBuzz一样, 也是一个开源字体库. 它是一个用C语言实现的一个字体光栅化库。它可以用来将字符栅格化并映射成位图以及提供其他字体相关业务的支持

  • Preview(预览): 功能已经基本完整, 可以试用了. 可以简单理解为beta公测版. 来源于 JEP12

    功能以预览版的形式发布，以收集有关它们的反馈而不承诺保持其向后兼容性——这意味着鼓励每个人尝试它们，但同时不鼓励在生产中使用它们。

    预览功能不是开箱即用的，为了访问它们，需要使用*–enable-preview*编译器标志。

  • Incubator(孵化) : 实验性 API已经到了一定阶段, 已经计划开发出一整套完整的功能.以独立模块的形式发布. 来源于 JEP11

  • Experimental(实验) : vm级的早期功能, 不稳定, 功能不完整. 实验性质.

    实验性功能代表（主要是）VM 级功能的早期版本，这些功能可能是有风险的、不完整的，甚至是不稳定的。在大多数情况下，需要使用专用标志启用它们

    出于比较的目的，如果一个实验功能被认为是 25%“完成”，那么一个预览功能应该至少 95%“完成”。

    预览,孵化,实验三者的关系大致: 实验 => 孵化 => 预览 => 合并jdk主体功能.

  • JEP : JDK Enhancement Proposal , jdk增强建议. 也就是我们常说的jdk新特性的来源. JEP大全

往期文章

jdk19新特性

参考文章

jdk20官方文档
jdk20新特性文档
jdk20升级指南
jdk20安装指南
jdk20的开发计划
jdk20虚拟机简介
jdk20垃圾回收机制
jdk20安全机制

openjdk bug反馈系统
openjdk官网
jdk中预览,实验,孵化的关系

]]> + + + + + java + + java版本特性 + + + + + + + java + + + + + + + + + 通过frp实现内网穿透功能 + + /2023/03/26/net-intranet-frp/ + + 让我们从0开始搭建一个很酷的内网穿透功能.

作为一名程序员,谁不想拥有一个自己的云服务器呢. 但是当我们看了各大云服务器厂商的价格后, 不禁陷入了沉思:我好像对云服务器的诉求也没那么大!
等我们回家看到家里闲置的老旧电脑时,又会想,我为啥要用云服务器呢,家里的电脑改吧改吧, 不也就可以用了. 我们又不用做大流量的网站,
最多搞搞博客,跑跑爬虫啥的,只要能让我们可以随时在外面访问我家里的电脑,控制家里的电脑就行了.
好的,说干就干, 经过一番调研, 我们发现, 好像没自己想象的那么简单. 一个最直接的问题就是, 我们没有一个自己的ip,因为众所周知的ipv4资源耗尽的问题,
我们家里实际上网的ip其实不是固定的, 而是多家用户共享一个ip地址,也就是NAT(Network Address Translation)技术. 所以,从外网我们是无法直接访问家里的电脑的.
这个问题怎么解决呢? 就是我们今天要聊的话题, 内网穿透技术.

什么是内网穿透

内网穿透，也即NAT穿透，进行NAT穿透是为了使具有某一个特定源IP地址和源端口号的数据包不被NAT设备屏蔽而正确路由到内网主机.
大致流程如图:
内网穿透图

准备工作

  1. 一台云服务器, 最便宜的即可,我们主要用其来注册内网服务器, 转发请求
  2. frp工具
  3. 家用电脑,台式,笔记本都行,操作系统任意.

开始内网穿透

云服务器搭建frp服务

参考官方安装frp说明, 下载合适自己服务器的frp版本, 解压到自定义的frp服务目录.
因为是服务器部分, 我们直接启用frps 即可启动成功frp的服务部分. 

1
2
# 启动frps, 并指定配置文件为frps.ini 
./frps -c ./frps.ini

配置部分参考官方配置样例. 我们demo样例只使用ssh基本服务, 就用了默认配置.

1
2
[common]
bind_port = 7000

配置frps为系统服务(选做)

为了方便, 我们一般会将frps配置成系统重启自动加载. 这样我们就不用担心服务器系统重启导致内网穿透服务掉线了.
方法如下:

  1. 先确认系统支持systemd, 如果不支持请安装
1
2
3
4
# yum
yum install systemd
# apt
apt install systemd
  1. 配置frps.service服务
1
vim /etc/systemd/system/frps.service

写入下面内容

1
2
3
4
5
6
7
8
9
10
11
12
13
[Unit]
# 服务名称，可自定义
Description = frp server
After = network.target syslog.target
Wants = network.target

[Service]
Type = simple
# 启动frps的命令，需修改为您的frps的安装路径
ExecStart = /path/to/frps -c /path/to/frps.ini

[Install]
WantedBy = multi-user.target
  1. 开机自动启动
1
systemctl enable frps

家用电脑安装frp客户端

我家里的电脑是windows10, 当然, Linux更好. 本次内网穿透的目的是可以通过远程ssh控制我的家用电脑.

win10的一些准备功能

windows系统作为家用本, 对网络权限限制的比较多, 需要我们额外做一些操作.
a. 安装windows的ssh服务端
win10默认是不支持ssh的服务端的, 需要我们安装相应的OpenSSH服务器.
操作步骤: 设置->应用-> 应用与功能 -> 可选功能 -> 添加OpenSSH服务器
openssh-s1
openssh-s2
openssh-s3
最后开启ssh服务,以管理员身份打开cmd终端,执行如下命令 

1
net start sshd

b. 防火墙可能会将frpc识别为危险文件, 记得去防火墙那里将工具恢复.

配置frp客户端

从官网下载下frpc客户端后,且成功从防火墙那里逃生, 就可以继续后面的操作了
首先同样先修改配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
[common]
# 你的云服务器实际ip
server_addr = x.x.x.x 
# 云服务配置的端口
server_port = 7000

[ssh]
type = tcp
local_ip = 127.0.0.1
# 本地要暴露的端口, windows网络限制比较严格,记得去防火墙打开相应端口
local_port = 22
# 远程服务器监听的端口. 意思就是frps服务器监听6000的端口, 然后把请求转发的本地的22端口上.
remote_port = 6000

然后打开cmd终端使用命令行的方式启动frpc工具
最后就可以在外网使用ssh命令访问你的系统了

1
ssh -oPort=6000 你的系统用户名@x.x.x.x

frp 会将请求 x.x.x.x:6000 的流量转发到内网机器的 22 端口

修改window默认终端为powerShell(选做)

windows的默认终端为cmd, 很多命令不与linux兼容. 所以建议将windows的默认终端改为powerShell, 更方便.

1
New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" -PropertyType String -Force

参考

]]> + + + + + 编程人生 + + + + + + + 内网穿透 + + + + + + + + + mac系统通过homebrew安装nginx + + /2023/03/24/homebrew-install-nginx/ + + 准备
  • mac系统
  • homebrew 环境已经配置好

操作步骤

  1. 查看本地是否安装nginx
1
brew search nginx

brew-search-nginx-not-find
nginx上面没有显示✓,表示nginx没有安装

  1. 查看nginx信息
1
brew info nginx

brew-info-nginx-not-find
如图所示,显示了nginx的版本. 也明确说明了系统没有安装nginx
3. 安装nginx

1
brew install nginx

brew-install-nginx-success
安装nginx成功.
nginx默认监听8080端口, 配置文件路径也给出来了 /opt/homebrew/etc/nginx/nginx.conf
同时也给了启动nginx的命令

1
brew services start nginx

4.验证安装成功
此时,nginx命令已经生效了.

1
nginx -v

nginx-version

当然, 也可以执行下面命令查看更详细的信息

1
nginx -V

至此,nginx已经安装成功了. 可以通过去配置文件修改相应配置, 启动nginx了

启动nginx

1
2
3
# 启动
nginx
brew services start nginx

启动成功了,此时可以通过 http://localhost:8080 验证一下
nginx-http

补充nginx的常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 查看版本
nginx -v
nginx -V

# 启动
nginx # 加载默认配置
nginx -c 配置文件路径 # 加载指定配置文件
brew services start nginx


# 停止
nginx -s stop # 快速停止
nginx -s quit # 安全停止

# 不重启加载配置
nginx -s reload 

# 验证配置
nginx -t

好的, 接下来尽情使用自己的nginx服务器吧!

]]> + + + + + 编程人生 + + nginx + + + + + + + nginx + + + + + + + + + es在java工程中如何支持自定义的json格式的DSL + + /2022/11/17/es-query-dsl-wrapper/ + + 背景

版本

  • Elasticsearch : v 6.6
  • elasticsearch-rest-high-level-client.jar : v 6.6.2

目标

想提供一个web接口, 入参就是es的查询DSL json. 然后服务器用这个DSL透传转发到Elasticsearch服务期, 将数据返回给接口.
简单来说, 就是想在自己服务器上实现类似kibana上查询Elasticsearch数据的功能.

比如, 我们正常的查询DSL如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
    "size":1,
    "query":{
        "bool":{
            "filter":[
                {
                    "terms":{
                        "userCode":[
                            "110111"
                        ]
                    }
                },
                {
                    "term":{
                        "address":{
                            "value":"beijing"
                        }
                    }
                }
            ]
        }
    }
}

实现

查询

如果是单纯的查询, 官方提供了一个透传查询DSL的实现类 QueryBuilders.wrapperQuery(), 可以通过这个QueryBuilders来实现我们自定义DSL的透传.
让我们先看看官方怎么说

A query that accepts any other query as base64 encoded string.
This query is more useful in the context of the Java high-level REST client or transport client to also accept queries as json formatted string. In these cases queries can be specified as a json or yaml formatted string or as a query builder (which is a available in the Java high-level REST client).

官方示例:

1
2
3
4
5
6
7
8
9
curl -X GET "localhost:9200/_search?pretty" -H 'Content-Type: application/json' -d'
{
    "query" : {
        "wrapper": {
            "query" : "eyJ0ZXJtIiA6IHsgInVzZXIiIDogIktpbWNoeSIgfX0=" 
        }
    }
}
'

由此可见, 官方是将wrapper当做一个关键字类型来处理的, 将我们的查询DSL转成base64,交给es服务器解析处理.
好,下面就是我们将上述DSL 通过QueryBuilders.wrapperQuery()处理后的sql.

1
2
3
4
5
{
  "wrapper" : {
    "query" : "eyJzaXplIjoxLCJxdWVyeSI6eyJib29sIjp7ImZpbHRlciI6W3sidGVybXMiOnsidXNlckNvZGUiOlsiMTEwMTExIl19fSx7InRlcm0iOnsiYWRkcmVzcyI6eyJ2YWx1ZSI6ImJlaWppbmcifX19XX19fQ=="
  }
}

大家可以找个base64解码网站处理一下, 发现和我们的DSL一样. 然后用官方的方式处理下

1
2
3
4
5
6
7
{
  "query" : {
    "wrapper": {
      "query" : "eyJzaXplIjoxLCJxdWVyeSI6eyJib29sIjp7ImZpbHRlciI6W3sidGVybXMiOnsidXNlckNvZGUiOlsiMTEwMTExIl19fSx7InRlcm0iOnsiYWRkcmVzcyI6eyJ2YWx1ZSI6ImJlaWppbmcifX19XX19fQ=="
    }
  }
}

唉, 发现查询报错了, 为什么呢?
size malformed

其实仔细分析一下,很容易发现问题. 我们将base64还原,看看最后的查询DSL的样子

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "query":{
    "wrapper":{
      "query":{
        "size":1,
        "query":{
          "bool":{
            "filter":[
              {
                "terms":{
                  "userCode":["110111"]
                }
              },
              {
                "term":{
                  "address":{"value":"beijing"}
                }
              }
            ]
          }
        }
      }
    }
  }
}

发现没, query里套query, 明显查询有问题. 其实这里es解析的时候, 发现wrapper关键字, 就会将下面的query查询替换原始query.

所以我们要将wrapper的不是原始完整的DSL,而是query下面的DSL. 我们将bool关键字的JSON重新单独拿出来处理下

1
2
3
4
5
6
7
{
  "query" : {
    "wrapper": {
      "query" : "eyJib29sIjp7ImZpbHRlciI6W3sidGVybXMiOnsidXNlckNvZGUiOlsiMTEwMTExIl19fSx7InRlcm0iOnsiYWRkcmVzcyI6eyJ2YWx1ZSI6ImJlaWppbmcifX19XX19"
    }
  }
}

搞定, 把上述DSL放到任何一个es的web客户端查询, 都有效.

聚合

关于聚合的功能, 官方没有提供现成的解析方法.
不过我觉得, 既然es的web端可以调用任意DSL, 通过java肯定能, 大不了就跳过RestHighLevelClient, 在RestLowLevelClient上想办法.

// todo 等我找到合适的办法再补充.

java源码

1
2
3
4
5
6
7
8
9
10
11
class A {
    public void search(String boolJson) throws IOException {

        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
        // query dsl 包装
        searchSourceBuilder.query(QueryBuilders.wrapperQuery(boolJson));
        searchSourceBuilder.size(1);
        
        Optional<SearchResponse> response = restHighLevelClient.search(searchSourceBuilder);
    }   
}

参考

]]> + + + + + 编程人生 + + Elasticsearch + + + + + + + elasticsearch + + + + + + + + + macOS升级13 ventura后git无法使用的解决办法 + + /2022/11/01/git-in-mac13-invalid/ + + 现象

最近, mac推送了新版本系统, macOS 13 ventura版本. 然后忍不住升级了. 升级过程不赘述, 等着就行了.

升级完成后, 打开idea, 发现git无法使用了, 提示如下:

1
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

不用说, 一定是升级导致的问题.

解决

经过一番排查, 发现是mac的开发工具Xcode需要升级到14才行. 可以使用如下命令解决, 实测有效

1
xcode-select --install

基本到这里, 问题就解决了.
如何还不行, 可以自行到官网下载软件安装即可.
xcode14图片

总结

没事别乱升级系统

参考

解决方案

]]> + + + + + 编程人生 + + git + + + + + + + git + + + + + + + + + JDK 19新特性简介 + + /2022/10/20/java-jdk-v19/ + + JDK 19在2022年10月18日发布了, 本文就是简单介绍一下这次更新的新特性与改动.

一句话总结, 这仍然是jdk的一个短期支持版本, 而且官方承诺,这次升级将尽可能的保证版本的向下兼容.

新特性汇总

新特性

1 预览版

  • JEP 425 Virtual Threads(虚拟线程) : 类似go的协程. 就是在线程上面在开辟出一个更细粒度独立运行的单元. 这个新单元就是虚拟线程, 这个线程官方叫carrier thead(承载线程?)
  • JEP 405 Record Patterns (记录模式) : Record Patterns 可对 record 的值进行解构，Record patterns 和 Type patterns 通过嵌套能够实现强大的、声明性的、可组合的数据导航和处理形式.
  • JEP 427 Pattern Matching for switch (switch模式匹配) : 第三次预览. 用 switch 表达式和语句的模式匹配，以及对模式语言的扩展来增强 Java 编程语言。将模式匹配扩展到 switch 中，允许针对一些模式测试表达式，这样就可以简明而安全地表达复杂的面向数据的查询。
  • JEP 424 Foreign Function & Memory API (外边函数&内存调用API): 提供了一套API 方便的调用 Java 运行时之外的代码或内存。通过高效地调用外部函数（即 JVM 之外的代码）和安全地访问外部内存（即不受 JVM 管理的内存），该 API 使 Java 程序能够调用本机库并处理本机数据，而不会像 JNI 那样危险和脆弱. (Java 在堆外内存使用的路上越走越远 🤪)

2 孵化器

  • JEP 428 Structured Concurrency(结构化并发) : 用来简化并发的功能. 可以将底层多个线程视为一个工作单元, 从而实现像单线程那样的异常处理, 结果收集.
  • JEP 426 Vector API (向量API) : 第四孵化阶段. 向量计算由对向量的一系列操作组成。向量 API 用来表达向量计算，该计算可以在运行时可靠地编译为支持的 CPU 架构上的最佳向量指令，从而实现优于等效标量计算的性能。向量 API 的目标是为用户提供简洁易用且与平台无关的表达范围广泛的向量计算

3 主要特性

  • Support Unicode 14.0 (JDK-8268081) : 支持Unicode14.0 .

  • New system properties for System.out and System.err (JDK-8283620) : 新增了stdout.encoding和 stderr.encoding 两个属性来支持标准输出和错误输出的字符集编码. 可以有效解决标准输出的乱码问题.

  • HTTPS Channel Binding Support for Java GSS/Kerberos (JDK-8279842) : 在https连接的时候, 支持绑定token来增强安全.

  • Additional Date-Time Formats (JDK-8176706) : java.time.format.DateTimeFormatter 增加了一些新的默认格式

  • New Methods to Create Preallocated HashMaps and HashSets (JDK-8186958) : HashMap, HashSet新增了一些静态创建方法. 比如

    1
    2
    3
    4
    5
    HashMap.newHashMap
    LinkedHashMap.newLinkedHashMap
    WeakHashMap.newWeakHashMap
    HashSet.newHashSet
    LinkedHashSet.newLinkedHashSet

  • upport for PAC-RET Protection on Linux/AArch64 (JDK-8277204) : 通过支持ARMv8.3 的PAC功能来防御RET的攻击

    When enabled, OpenJDK will use hardware features from the ARMv8.3 Pointer Authentication Code (PAC) extension to protect against Return Orientated Programming (ROP) attacks. For more information on the PAC extension see “Providing protection for complex software” or the “Pointer authentication in AArch64 state” section in the Arm ARM.

  • Automatic Generation of the CDS Archive (JDK-8261455) : CDS的自动打包功能

  • Windows KeyStore Updated to Include Access to the Local Machine Location (JDK-6782021) : Windows新增了一些密钥储库支持访问本地位置.

  • Break Up SEQUENCE in X509Certificate and X509Certificate in otherName (JDK-8277976) : 如题, 这两个方法的增强.

    The JDK implementation of X509Certificate::getSubjectAlternativeNames and X509Certificate::getIssuerAlternativeNames has been enhanced to additionally return the type-id and value fields of an otherName. The value field is returned as a String if it is encoded as a character string or otherwise as a byte array, which is helpful as it avoids having to parse the ASN.1 DER encoded form of the name.

  • (D)TLS Signature Schemes (JDK-8280494): 增加了一套新的获取TLS签名的方法.

  • Add a -providerPath Option to jarsigner (JDK-8281175) : jarsigner新增了一个选项, 用来指定备用密钥库路径

  • New Options for ktab to Provide Non-default Salt (JDK-8279064) : ktab命令增加了一些选项来支持自定义’盐’值.

    ktab -a username password -s altsalt

  • New XML Processing Limits (JDK-8270504 (not public)) : xml库解析执行增加了3个限制

    jdk.xml.xpathExprOpLimit : XPath表达式中group数量的限制

    jdk.xml.xpathExprOpLimit : XPath表达式中operator数量的限制

    jdk.xml.xpathTotalOpLimit : XPath文件中operator总数量的限制

bug修复

  • JDK-8289853 : HarfBuzz库升级 到 to 4.4.1, 支持最新的字体
  • JDK-8290334 : FreeType 升级到 2.12.1
  • JDK-8291897 : 解决TerminatingThreadLocal在virtual thread(虚拟线程)某些场景下无法注册的问题
  • JDK-8292240 : 虚拟线程的承载线程, 某些情况下阻塞时无法重置状态的问题
  • JDK-8287917 : macOS SDK 10.15 及更早版本下System.loadLibrary不生效的问题
  • JDK-8292654 : JDK-8286115问题修复导致的G1垃圾回收器 remembered set memory footprint问题

移出功能

  • Diagnostic Flag GCParallelVerificationEnabled (JDK-8286304) : 这个开关被移出了. 因为自从创建以来一直都是默认开启, 且并发效率比关闭高很多.
  • Finalizer Implementation in SSLSocketImpl (JDK-8212136) : SSLSocket的finalizer被移除, 因为基础方法(native)已经实现相关功能.
  • Alternate ThreadLocal Implementation of the Subject::current and Subject::callAs APIs (JDK-8282676 (not public)) : 所述类里的相应方法的备用threadlocal实现被移除.

废弃功能

  • java.lang.ThreadGroup (JDK-8284161) : 线程组被标记为废弃. 最大的原因是虚拟线程来了.
  • Locale Class Constructors (JDK-8282819) : Locale的构造器被 Locale.of() 方法替代
  • PSSParameterSpec(int) Constructor and DEFAULT Static Constant (JDK-8254935)
  • OAEPParameterSpec.DEFAULT Static Constant (JDK-8284553) : 因为密码学的进步, 这个Default常量已经落后了.

小优化

这里主要介绍一些小的优化, 太长可以不看.

  1. JDK19中, 在macOS上将Metal作为图形渲染的默认配置.

  2. 像mac或linux系统中, user.home 存在就用系统提供的配置 , 如果不存在, 则使用$HOME的配置设置这个系统属性.

  3. 线程的ClassLoader 被处理为一个特殊的可继承的Thread-local

  4. java.lang.Thread 新增了一些方法, 如果现在代码继承了Thread, 可能会导致不兼容.

    Thread.Builder模式

    Thread.isVirtual()

    Thread.threadId()

    Thread.join(Duration)

  5. Double.toString(double) and Float.toString(float) 针对科学记数法的一些优化

  6. 注解的toString方法针对常量和枚举, 做了一些优化, 输出更友好.

  7. HTTP签名鉴权时, MD5和SHA-1 因为不太安全默认被禁用.

  8. Windows 上http多代理选择的优化

  9. java.net.InetAddress 针对一些有歧义的IPv4输入, 精细了异常提示.

  10. HttpURLConnection 的默认keep alive 可配置

  11. FileChannel.transferFrom 返回的bytes 可能会小于预订值, 这是允许的.

    FileChannel.transferFrom()的性能在Linux内核4.5及更高版本上得到了显著提高

  12. InputStream and FilterInputStream 的mark和reset 移出了 synchronized 关键字

  13. Files.copy 方法支持将 POSIX属性跨文件系统复制, 前提是两个系统都支持 POSIX

  14. FileChannel.lock(long position, long size, boolean shared) 当size指定为0时, 表示锁定 整个文件, 无论这个文件流被扩展或继承

  15. java.time.chrono 新增了3个标准时间

  16. ForkJoinPool 和 ThreadPoolExecutor 线程池不再使用Thread.start来启动工作线程.

  17. 正则 \b 可以匹配ASCII 字符, 像 \w 一样.

  18. 支持 CLDR Version 41

  19. LDAP, DNS, 和 RMI 的URL解析更加严格

>    -Dcom.sun.jndi.ldapURLParsing="legacy" | "compat" | "strict"    (to control "ldap:" URLs)>>    -Dcom.sun.jndi.dnsURLParsing="legacy" | "compat" | "strict"     (to control "dns:" URLs)>    -Dcom.sun.jndi.rmiURLParsing="legacy" | "compat" | "strict"     (to control "rmi:" URLs)

  1. VM Tool Interface (JVM TI) 支持虚拟线程

  2. cpu计算时不再考虑cpu.share , 因为会导致jvm对当前cpu使用情况的误算, 进而影响cpu使用率.

    之前的JDK版本对Linux cgroups参数“cpu.shares”使用了错误的解释。这可能会导致JVM使用的CPU少于可用，导致JVM在容器内使用时CPU资源利用率不足。

    从此JDK版本开始，默认情况下，JVM在决定各种线程池使用的线程数量时不再考虑“cpu.shares”。-XX:+UseContainerCpuShares命令行选项可用于恢复到之前的行为。此选项已被弃用，可能会在未来的JDK版本中删除。

  3. 此后, macOS中,相同大版本的jdk将默认安装到同一目录

    Oracle JDK安装目录从

    /Library/Java/JavaVirtualMachines/jdk-${VERSION}.jdk 迁移到

    /Library/Java/JavaVirtualMachines/jdk-${FEATURE}.jdk

    比如: 19.0.1 and 19.0.2 版本都将安装到 /Library/Java/JavaVirtualMachines/jdk-19.jdk 中

  4. 在macOS上，只有用户钥匙串中具有正确信任设置的证书才会在钥匙串类型的钥匙库中作为受信任证书条目公开

  5. RC2和ARCFOUR（RC4）算法已添加到java.security配置文件中的jdk.security.legacyAlgorithms安全属性中。当弱RC2或ARCFOUR算法用于与密钥存储中的秘密密钥条目关联的命令时，密钥工具会发出警告。

  6. 加密算法位数增强

RSA, RSASSA-PSS, DH: from 2048 to 3072

EC: from 256 to 384

AES: from 128 to 256 (if permitted by crypto policy), falls back to 128 otherwise.

  1. ECDSA 算法的 Signature::getParameters 永远返回null . 参考 RFC 5758 Section 3.2
  2. DES、DESede和MD5算法已添加到java.security配置文件中的jdk.security.legacyAlgorithms安全属性中。当弱DES或DESede算法用于与密钥库中的秘密密钥条目关联的命令时，keytool工具会发出警告。
  3. 加密算法完成支持 RFC 6125
  4. 移出了一些过时的3DES加密组件

TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA

TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA

SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA

SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA

TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA

TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA

SSL_RSA_WITH_3DES_EDE_CBC_SHA

30 修复了一个StringBuilder bug. 例如, 下面代码输出”foofoobar” 而不是 “foobarfoobar”

1
2
StringBuilder builder = new StringBuilder("foo");
System.err.println("" + builder + builder.append("bar"));

  1. JavaDoc生成的API文档现在提供了一个独立的搜索页面，搜索语法已得到增强，允许多个搜索词。

  2. JShell现在标记不建议使用的元素，并在控制台中突出显示变量和关键字。

  3. 实际的java线程堆栈大小可能与-Xss命令行选项指定的值不同；当操作系统要求时，它可以四舍五入到系统页面大小的倍数。

名词解析

  • HarfBuzz: 一个开源的用于文字塑形的软件开发库，亦即用于转换Unicode文本到字形指标及方位的过程

  • FreeType: 同HarfBuzz一样, 也是一个开源字体库. 它是一个用C语言实现的一个字体光栅化库。它可以用来将字符栅格化并映射成位图以及提供其他字体相关业务的支持

  • Preview(预览): 功能已经基本完整, 可以试用了. 可以简单理解为beta公测版. 来源于 JEP12

    功能以预览版的形式发布，以收集有关它们的反馈而不承诺保持其向后兼容性——这意味着鼓励每个人尝试它们，但同时不鼓励在生产中使用它们。

    预览功能不是开箱即用的，为了访问它们，需要使用*–enable-preview*编译器标志。

  • Incubator(孵化) : 实验性 API已经到了一定阶段, 已经计划开发出一整套完整的功能.以独立模块的形式发布. 来源于 JEP11

  • Experimental(实验) : vm级的早期功能, 不稳定, 功能不完整. 实验性质.

    实验性功能代表（主要是）VM 级功能的早期版本，这些功能可能是有风险的、不完整的，甚至是不稳定的。在大多数情况下，需要使用专用标志启用它们

    出于比较的目的，如果一个实验功能被认为是 25%“完成”，那么一个预览功能应该至少 95%“完成”。

    预览,孵化,实验三者的关系大致: 实验 => 孵化 => 预览 => 合并jdk主体功能.

  • JEP : JDK Enhancement Proposal , jdk增强建议. 也就是我们常说的jdk新特性的来源. JEP大全

参考文章

jdk19官方文档

jdk19 新特性文档

jdk19升级指南

jdk19的开发计划

openjdk bug反馈系统

openjdk官网

jdk中预览,实验,孵化的关系

FreeType开源中国

HarfBuzz开源中国

]]> + + + + + java + + java版本特性 + + + + + + + java + + + + + + + + + dubbo 在线平滑变更zookeeper + + /2022/10/06/dubbo-zk-change/ + + 记一次dubbo zk集群平滑迁移的操作方案，也可以用户dubbo双注册中心的实现方案。

准备

  1. zk 服务器版本：3.4.6
  2. dubbo 版本：2.7.3
  3. dubbo-spring-boot-starter 版本：2.7.3

技术方案

  1. 运维同学搭建好新的zk集群，保证高可用
  2. dubbo 服务提供者通过双注册中心的方式，将服务注册到new，old 两套集群上
  3. dubbo 消费者 通过配置双注册中心的方式，同时消费两个注册中心的服务
  4. 步骤2，步骤3可以同时进行，直到全部服务平滑注册到双注册中心
  5. 等全部到双中心后（需要运维同学确认），再次更改消费者配置，改为new 注册中心
  6. 关于即是生产者，又是消费者的项目，有两种方案：
    • 等依赖上游切换后再切换，或者最后切换
    • 差异化配置，消费者单注册中心，生产者双注册中心
  7. 消费者全部切换到新的zk 集群后，生产者逐步全部改为新的zk集群
  8. 关闭下线old zk 集群

关键配置

pom 依赖

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>2.7.3</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-framework</artifactId>
    <version>4.2.0</version>
    <exclusions>
        <exclusion>
            <artifactId>zookeeper</artifactId>
            <groupId>org.apache.zookeeper</groupId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>4.2.0</version>
</dependency>
<dependency>
    <groupId>org.apache.zookeeper</groupId>
    <artifactId>zookeeper</artifactId>
    <version>3.4.13</version>
    <exclusions>
        <exclusion>
            <artifactId>slf4j-log4j12</artifactId>
            <groupId>org.slf4j</groupId>
        </exclusion>
    </exclusions>
</dependency>

dubbo配置：

1
2
3
4
5
6
7
8
9
10
11
12
dubbo:
  application:
    name: zk-move-test
  consumer:
    registries:
      - id: oldzk
        protocol: zookeeper
        address: 127.0.0.1:2181(此处随意配)
      - id: newzk
        protocol: zookeeper
        address: 127.1.1.1:2181,127.2.2.2:2181(此处随意配)

然后就能正常启动了，通过日志，会发现正常注册了两个zk中心，并且zk上也能发现注册的服务。

技术验证点

  1. 某服务注册到old中心，new 中心没有，消费者双注册中心是否能发现？答：可以
  2. 某服务注册到new 中心，old中心没有，消费者双注册中心是否能发现？答：可以
  3. 某服务双注册中心，然后下线某注册中心，消费者双注册中心是否收影响，能否自动转移？
    答：经测试，new中心全部挂掉后，服务依旧会从old服务发现，功能不受影响。
    但是，dubbo客户端会一直尝试重新连接zk中心（可配置），直到new中心重启后，zk能够自动重连成功为止。所以，我们这个场景，需要生产、消费者全部迁移到new zk 上后才能下线old zk。

参考文章

http://dubbo.apache.org/zh-cn/docs/user/references/registry/zookeeper.html

]]> + + + + + dubbo + + + + + + + java + + dubbo + + + + + + + + + 鸿蒙应用开发:"request data error"问题解决 + + /2022/10/05/exception-harmony-qa-http-request-err/ + + 背景介绍

本人初次接触鸿蒙系统, 想着自己在手机上开发个app玩玩, 结果第一步就遇到坑了~~

开发环境

  • ide: DevEco Studio 3.0 Release
  • harmony SDK: 8
  • 语言: ets/ts
  • 调试: 本地真机调试

请求源码

因为是个demo, 其实就是从官方demo中copy过来的, 然后换成自己的域名地址

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
import http from '@ohos.net.http';

// 每一个httpRequest对应一个http请求任务，不可复用
let httpRequest = http.createHttp();
// 用于订阅http响应头，此接口会比request请求先返回。可以根据业务需要订阅此消息
// 从API 8开始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。 8+
httpRequest.on('headersReceive', (header) => {
    console.info('header: ' + JSON.stringify(header));
});
httpRequest.request(
    // 填写http请求的url地址，可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
    "http://hancher.top/xxx/xxx",
    {
        method: http.RequestMethod.POST, // 可选，默认为http.RequestMethod.GET
        // 开发者根据自身业务需要添加header字段
        header: {
            'Content-Type': 'application/json'
        },
        // 当使用POST请求时此字段用于传递内容
        extraData: {
            "data": "data to send",
        },
        connectTimeout: 60000, // 可选，默认为60s
        readTimeout: 60000, // 可选，默认为60s
    }, (err, data) => {
        if (!err) {
            // data.result为http响应内容，可根据业务需要进行解析
            console.info('http请求结果:' + data.result);
            console.info('code:' + data.responseCode);
            // data.header为http响应头，可根据业务需要进行解析
            console.info('header:' + JSON.stringify(data.header));
            console.info('cookies:' + data.cookies); // 8+
        } else {
            console.info('http请求异常:' + JSON.stringify(err));
            // 当该请求使用完毕时，调用destroy方法主动销毁。
            httpRequest.destroy();
        }
    }
);

大家可以从参考里的官方demo里比对一下, 啥都没变, 然后本地调试, 报

1
03B00/JSApp:  app Log: http请求异常:{"code":200,"data":"request data error"}

多说一句, 因为是初次使用这个ide, 日志的打印入口都找了半天. 下面是日志的路径

底部导航log-> HiLog -> 选中自己的设备 -> 选择日志级别
HiLog 入口

问题定位

  1. 首先, 请求肯定没有发出去. 因为我没有在我的后台里发现对应的请求
  2. 有没有可能是请求参数体的问题呢?
    这个我查了半天官方文档, 以及自己试了字符串, 对应, 数组等各种方式, 都不行. 感觉应该不是这个问题.
  3. 是不是权限的问题呢?
    之所以会怀疑到权限的问题上, 因为在查看接口文档的时候发现了这么一句话

    需要权限：ohos.permission.INTERNET

然后就去查权限相关的文档, 在模块的config.json下面把权限加上, 还是不行. 配置如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.GET_NETWORK_INFO",
        "reason": "流量网络请求"
      },
      {
        "name": "ohos.permission.INTERNET",
        "reason": "流量网络请求"
      },
      {
        "name": "ohos.permission.SET_NETWORK_INFO",
        "reason": "流量网络请求"
      },
      {
        "name": "ohos.permission.MANAGE_WIFI_CONNECTION",
        "reason": "WLAN网络请求"
      },
      {
        "name": "ohos.permission.SET_WIFI_INFO",
        "reason": "WLAN网络请求"
      },
      {
        "name": "ohos.permission.GET_WIFI_INFO",
        "reason": "WLAN网络请求"
      }
    ]
  }
}

请求结果还是老样子.
4. 最终定位: http明文请求被限制了
这是我在一位老哥的帖子里发现的一个关键节点.
原来正常的http请求会被系统默认禁掉, 而且官方还不给个提示, 太坑了. 官方更推荐使用https的请求方式.
http被禁用
知道了问题所在, 解决问题就好了.config.json添加如下配置即可

1
2
3
4
5
6
7
"deviceConfig": {
  "default": {
    "network": {
      "cleartextTraffic": true
    }
  }
}

注意, 3里的网络权限也要配置哈, 不然会报没有权限的错误. 不过这个还好, 官方有异常提示了, 就很好定位了.

参考

http请求官方文档
应用配置官方文档
感谢老哥

]]> + + + + + 鸿蒙 + + app + + + + + + + 鸿蒙 + + 异常 + + + + + + + + + redis常用命令总结 + + /2022/09/30/db-redis-common-cmd/ + + k-v操作

普通的k-v操作

批量操作

1.通过lua在redis客户端批量删除key

redis是不支持批量删除指令的, 因为redis是单线程的. 批量删除会占用redis的主线程.影响性能.

但是我认为现在redis既然已经支持异步线程操作一些后台数据了, 也就可以支持在不影响主线程性能的情况下实现 正则批量删除数据的命令了. 不知为何还是没有.

这里记录一下使用lua脚本, 在redis命令行里 通过正则批量删除缓存的功能. 核心是使用 keys命令. 这个会阻塞主线程, 如果量比较大, 慎用.

1
eval "local keys=redis.call('keys',KEYS[1]);local count=0;for i,v in ipairs(keys) do redis.call('del',v); count=i end; return count" 1 key正则表达式

将最后的’key正则表达式’换成自己想删除的keys的表达式即可.

关于量的问题, 我删除线上5w条缓存,秒删,无任何影响.各位同学自行参考量级.

不定期更新中…

参考

redis官网

]]> + + + + + redis + + + + + + + redis + + + + + + + + + redis脚本命令 + + /2022/09/29/db-redis-cmd-script/ + + redis内置了Lua 5.1引擎. 可以很方便的执行lua脚本.
有了这个利器, 我们就可以在redis命令的基础上自己组合命令并原子性执行了.

eval命令执行lua脚本

如果要调用

1
2
EVAL script numkeys [key [key ...]] [arg [arg ...]]

  • script lua脚本, 字符串
  • numkeys 后置keys的数量. 0表示没有参数
  • key 的参数. 可以在lua脚本里通过 “KEYS[index]”来指定key. 会在脚本执行前替换
  • arg 参数. 和keys类似. keys数量之后的参数都是args. 可以用ARGV[index]指定.

demo

1
2
3
4
5
6
7
# 执行一段lua脚本, 返回输入的各个参数. 前2个是key, 后面的都是args
redis> EVAL "return { KEYS[1], KEYS[2], ARGV[1], ARGV[2], ARGV[3] }" 2 key1 key2 arg1 arg2 arg3
1) "key1"
2) "key2"
3) "arg1"
4) "arg2"
5) "arg3"

lua脚本

lua脚本调redis指令

最常用的很是就是call方法了

1
2
redis.call(command [,arg...])

  • command redis命令
  • args redis命令所需参数

demo

1
2
3
4
5
# 执行lua脚本, 设置key=a , v = 1
redis> eval "redis.call('set','a',1)" 0

# 验证
redis> get a  # 结果 1

不定期更新中…

参考

redis lua

]]> + + + + + redis + + + + + + + redis + + + + + + + + + 有意思的小问题,java代码过长 + + /2022/09/22/exception-java-method-too-big/ + + 最近在练习编程的时候,发现一个问题. 就是在测试一个排序功能时, 如果写入大批量的参数, 会报 “java: 代码过长” 的问题.

编程这么多年了, 第一次遇到这种问题, 还挺神奇的. 记录和总结一下.

现象重现

1
2
3
4
5
6
7
8
public class Test {
    public static void main(String[] args) {
        a = "2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2";
        // 上面的a 多复制几遍

        System.out.println(a);
    }
}

很简单的代码, 没事走两步

1
java: 代码过长

问题分析

首先, 顾名思义, 很明细就是字符长度超过了java 一个类文件的最大长度限制导致的.

那么java类文件的长度是多少呢?
经过一番不是很辛苦的查询, 定位到了原因:

There is a 64K byte-code size limit on a method
java中一个方法的最大长度是64Kb

很明细, 我们的这个方法长度超了.

问题解决

原因找到了, 要解决也就很简单了. 只要做到规避方法的最大长度就行了.

  • 方法1 : 将一个大方法拆成多个小方法, 将一个大类拆成多个小类. 说实话, 一个64kb的类确实有点大了.
  • 方法2 : 将测试数据不要放到java类里, 而是放到配置文件中, 使用的时候通过流加载到内存中. 文件的存储量是无限的

总结

其实只要符合正常的java编码规范, 我们基本上是遇不到上面的问题的.
只有在一些极限测试的时候, 我们通常会将测试内容放到代码里, 才可能碰到.

只能说: 没用的小知识又增多了🐶

参考

java code too large

]]> + + + + + java异常 + + + + + + + java + + 异常 + + + + + + + + + 使用私有仓库发布 GitHub Pages + + /2022/09/13/site-github-repo-private/ + + 验证私有库发布文章

相信已经成功使用github建站的朋友们肯定会有一个想法, 就是可不可以将文章仓库私有也能实现建站的功能呢?

答案是可以的, 本文就是一个将一个公共仓库站点私有化后的例子. 并将过程总结一下, 方便大家参考使用.

站点私有化过程的的变与不变

首先,使用github pages建站, 项目名就固定死了,必然是<用户名>.github.io
其次,如果有域名的话,像域名配置等一些配置也是需要放到 外露站点下的.

除此之外, 其他的内容就就是可以变的了.因为github.io站点最终暴露的就是一个编译好的web静态网站.
至于源码是不是在这里,无所谓的.之所以源码与静态站点放到一起,核心还是方便github的 action自动编译.

好了, 了解了这些核心要素, 我们可以操作的部分也就有了.
就像我们正常的开发流程一样,我们可以把整个网站的发布流程拆分为两部分: 打包 与 发布.

其中打包可以在我们的私有仓库中进行, 然后将打包后的静态网站 发布到github.io公仓中.
这里就用到了github的 action 自动编译功能. 其会在我们提交代码的时候触发一个操作,
调用一段脚本命令执行.

而这段脚本的核心就是通过git 将编译后的静态站点push 到github.io公仓中.

流程如下:
发布流程图

操作步骤

  1. 先在github上创建一个私有仓库: private_repo.
  2. 将github.io的源码迁移到新的仓库中.
  3. 准备github跨仓库git 提交代码权限, 参考下一节github申请person token
  4. 在private_repo 的action 中创建打包脚本, 脚本内容参考附录1
    创建新action

github申请person token

第一步, 获取token

  1. 个人设置里找到入口
    person token 1
  2. 找到开发者设置
    person token 2
  3. 创建token
    person token 3

这一步一定要记住创建好的token, 因为后面要用,而且这个页面刷新后就没了.

其实有过使用ssh经验的朋友们应该已经意识到了, 这一步其实就是一个创建ssh公钥的过程. 只不过这个公钥是放到github服务器上了.

第二步, 私有库配置

有了token, 正常来说就能提交代码了. 但是要知道这个东西是放到脚本里的, 明文暴露还是不太安全.
所以我们要在私有库里将这个token配置成一个环境变量,通过环境变量引用的方式使用,这样就安全多了.

  1. 找到private_repo, 配置token环境变量
    person token 4
    person token 5
  2. 配置完后, 我们就可以在脚本里通过环境变量来使用token了.
1
${ { secrets.YOUR_REPO_SECRET_NAME } }

最后

可以尝试在私有库private_repo里提交文章了.

同时你会发现, github.io公仓里的内部全部被静态网站内容覆盖了. 不用担心,这是正常的.

附录1 : 完整脚本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# ci name
# ci 脚本名称
name: Deploy Jekyll site to public github repos

on:
  # Runs on pushes targeting the default branch
  # 当代码 push 到 main 分支时, 执行该脚本
  push:
    branches: ["main"]

  # Allows you to run this workflow manually from the Actions tab
  # 允许你 手动执行 这个脚本
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
# GITHUB_TOKEN 的操作权限
permissions:
  contents: read
  pages: write
  id-token: write

# Allow one concurrent deployment
concurrency:
  group: "pages"
  cancel-in-progress: true

# job 执行任务, 可以有多个, 默认并行运行, 可以通过 needs 关键字来设置依赖的其他 jobs
# step : 任务下的执行步骤, 一个job 会有多个步骤
# 操作:  一个step 下可以执行多个操作, 通常一行脚本为一个操作
jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      # 准备ruby 环境
      - name: Setup Ruby
        uses: ruby/setup-ruby@0a29871fe2b0200a17a4497bae54fe5df0d973aa # v1.115.3
        with:
          ruby-version: '3.0' # Not needed with a .ruby-version file
          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
          cache-version: 0 # Increment this number if you need to re-download cached gems
#      - name: Setup Pages
#        id: pages
#        uses: actions/configure-pages@v2
      # 打包 jekyll
      - name: Build with Jekyll
        # Outputs to the './_site' directory by default
#        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
        run: bundle exec jekyll build --verbose
        env:
          JEKYLL_ENV: production
       # 更新 打tar包
#      - name: Upload artifact
#        # Automatically uploads an artifact from the './_site' directory by default
#        uses: actions/upload-pages-artifact@v1

      - name: 增加外露github文件
        working-directory: ./_site  # jekyll 默认 build 到 _site 目录，因此设置命令执行的目录为 ./_site
        run: |  # run 后面加个 ‘|’ 然后换行可以同时执行多个命令，每行一个
          cp ../README.md .
 
      - name: 部署_site到博客网站仓库
        working-directory: ./_site
        run: |
          git init
          git checkout -b main
          git add -A
          git -c user.name='your_name' -c user.email='your_email' commit -m 'anything' 
          git push "https://${ { github.actor } }:${ { secrets.YOUR_REPO_SECRET_NAME } }@github.com/YOUR_GITHUB_IO_REPO" HEAD:main -f -q
  • 将上面的your_name,your_email,anything 替换成自己的内容
  • YOUR_REPO_SECRET_NAME 替换成privat_repo的secret_token_name
  • YOUR_GITHUB_IO_REPO 替换成自己的github.io公仓

附录2 : github action 脚本简介

在github的action模块里创建了一个脚本后, 就会在项目的.github/workflows里创建一个对应的文件.

通过workflow 大致可以理解这个模块的功能, 就是一个工作流.
在一些操作执行(通常是提交代码)后, 触发一系列的后续自动化操作, 这些操作可以是并行的,也可以是串行的.

而这些后续操作是通过一些action脚本组织起来的. 整体上看,一个action由以下部分组成.

  • jobs: 任务. 最大的逻辑单元. 可以有多个. jobs 默认是并行运行，可以通过 needs 关键字来设置依赖的其他 jobs。
  • steps: 步骤. job的执行步骤. 顺序执行. 可以job可以有多个步骤.
  • runs: 操作. 也可以理解为指令(bash命令等). 通常一行脚本就是一个操作. 并非所有步骤都会运行操作，但是操作都是在步骤中运行的

无论是job,还是step, 都可以理解一组指令集合. 他们都是可以配置id的. 可以通过id来互相依赖, 互相调用.

其他的可以参考里的官方文档.

参考

常见脚本

github action 官方文档

免费使用私有仓库发布 GitHub Pages

通过 GitHub Actions 实现私有仓库的免费 Github Pages 部署

]]> + + + + + 网站 + + + + + + + 建站 + + + + + + + + + Elasticsearch重建索引 + + /2022/09/12/es-reindex/ + + 为什么要重建索引

众所周知, es是一种高效的数据查询,检索引擎。 可以对海量的数据进行快速的查询。但是在使用es的时候，经常会遇到一个比较尴尬的问题，那就是es索引里的字段类型是固定的，不可修改的。而es的索引又是可以自动扩展字段的。 这个时候自动扩展出来的字段就是使用了默认的字段类型(通常是text类型)。

惊不惊喜！

查看索引字段的方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
GET /my_index

{
    "my_index":{
        "mappings":{
            "_doc":{
                "dynamic_templates":[
                    {
                        "string_fields":{
                            "match_mapping_type":"string",
                            "mapping":{
                                "type":"keyword"
                            }
                        }
                    }
                ],
                "properties":{
                    "field_a":{
                        "type":"keyword"
                    },
                    "field_b":{
                        "type":"date",
                        "format":"yyyy-MM-dd HH:mm:ss"
                    },
                    "field_c":{
                        "type":"text",
                        "norms":false,
                        "fields":{
                            "keyword":{
                                "type":"keyword",
                                "ignore_above":256
                            }
                        }
                    }
                }
            }
        }
    }
}

聪明的你肯定想到了, 如果我们忘记加字段了, 或者字段加错了要修改字段类型咋办? 这个时候场景的办法就只有一个了:

重建索引!

从数据库角度来看,也就是新增新表, 迁移数据, 删除老表.

背景 与 目标

Elasticsearch 版本 : v 6.6
目标: 在my_index 索引上新增一个integer字段. 且中间不间断服务.

S1: 使用别名代替实体索引

使用aliases api
创建一个别名my_index 指向实际的索引my_idex.
这样,我们通过my_index访问数据时, 就不会直接访问my_index索引了, 而是通过别名指向对应的索引.

1
2
3
4
5
6
POST /_aliases
{
    "actions" : [
        { "add" : { "index" : "my_index", "alias" : "my_index" } }
    ]
}

S2: 创建新的索引

使用 put mapping api
打算新增一个字段 fiedl_d, 数据类型.

因为默认的string类型是keyword (假设, 意会即可), 所以如果想要新增一个整型类型, 就不能通过自动的扩展字段使用默认类型的方式. 所以必须显式的指定字段类型.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
put my_index2

{
    "_doc":{
        "dynamic_templates":[
            {
                "string_fields":{
                    "match_mapping_type":"string",
                    "mapping":{
                        "type":"keyword"
                    }
                }
            }
        ],
        "properties":{
            "field_a":{
                "type":"keyword"
            },
            "field_b":{
                "type":"date",
                "format":"yyyy-MM-dd HH:mm:ss"
            },
            "field_c":{
                "type":"text",
                "norms":false,
                "fields":{
                    "keyword":{
                        "type":"keyword",
                        "ignore_above":256
                    }
                }
            },
            "field_d":{
                "type":"integer"
            }
        }
    }
}

S3: 迁移数据

使用 Reindex api
将老的my_index 数据迁移到新的my_index2上.
这一步比较耗时, 做好心理准备.

1
2
3
4
5
6
7
8
9
POST _reindex
{
  "source": {
    "index": "my_index"
  },
  "dest": {
    "index": "my_index2"
  }
}

S4: 变更别名

使用aliases api
将别名从老的index, 指向新的index

1
2
3
4
5
6
7
POST /_aliases
{
    "actions" : [
        { "remove" : { "index" : "my_index", "alias" : "my_index" } },
        { "add" : { "index" : "my_index2", "alias" : "my_index" } }
    ]
}

S5: 将老索引的增量数据迁移到新索引上

处理迁移期间my_index 发生的增量数据

1
2
3
4
5
6
7
8
9
10
11
POST _reindex
{
  "size": 10000,
  "source": {
    "index": "my_index",
    "sort": { "date": "desc" }
  },
  "dest": {
    "index": "my_index2"
  }
}

S6: 删除老索引

使用 delete api

1
delete my_index

总结

至此, 整个重建索引过程完毕.
很麻烦吧.
为了不这么麻烦, 以后要给es 增加新字段时, 一定要先通过maping的方式先新增字段. 然后再在代码里处理相对应的逻辑.

over!

补充说明

可以通过put mapping的方式, 增量补充索引的字段

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
PUT my_index
{
  "mappings": {
    "_doc": {
      "properties": {
        "manager": {
          "properties": {
            "age":  { "type": "integer" },
            "name": { "type": "text"  }
          }
        },
        "employees": {
          "type": "nested",
          "properties": {
            "age":  { "type": "integer" },
            "name": { "type": "text"  }
          }
        }
      }
    }
  }
}

参考

官方文档-api
官方文档-api2

]]> + + + + + 编程人生 + + Elasticsearch + + + + + + + elasticsearch + + + + + + + + + beaudar评论插件及常见问题解决 + + /2022/09/09/site-beaudar-error/ + + 什么是beaudar

Beaudar 名称源于粤语“表达”的发音，是 Utterances 的中文版本,是一款基于github issue 的一个评论插件

  • 开源
  • 没有追踪，没有广告，永久免费
  • 不保留数据，所有数据保存在用户 GitHub issue 中
  • 有源于 GitHub primer 的多个主题
  • 轻量化，没有字体下载，没有 JS 框架加载

本站的评论模块就是使用的 beaudar

使用

选择 Beaudar 将要连接的仓库, 也就是网站对应的github仓库。

  1. 确保仓库是公开的，否则您的读者将无法查看 Issue(评论)。
  2. 安装并确保 Beaudar app 已在仓库中安装，否则用户将无法发表评论。

点击这里安装beaudar

安装beaudar
3. 将网站对应的分支配置到配置中，并确保 Issues 功能已打开。
4. 将以下脚本标记添加到博客的模板中。 将其放置在要显示注释的位置。 使用 .beaudar 和 .beaudar-frame 选择器自定义布局。

1
2
3
4
5
6
7
8
9
10
11
12
13
<script src="https://beaudar.lipk.org/client.js"
        repo="在此处输入仓库"
        branch="main"
        issue-term="pathname"
        label="tag"
        theme="github-light"
        keep-theme="false"
        loading="false"
        comment-order="desc"
        input-position="top"
        crossorigin="anonymous"
        async>
</script>

配置解读

  • src : 评论插件客户端地址,不能动
  • repo : 网站仓库
  • branch : 网站部署分支
  • issue-term : 博客文章 与 Issue 的映射
    • pathname : Beaudar 将搜索标题包含博客文章 URL 路径的 Issue。如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue。
    • url : Beaudar 将搜索标题包含博客文章 URL 的 Issue。 如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue
    • title: Beaudar 将搜索标题包含博客文章标题的 Issue。 如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue
    • og:title : Beaudar 将搜索标题包含博客文章页面 meta 元素 og:title 的 Issue。 如果未找到匹配的 Issue，则当有人首次对您的信息发表评论时，Beaudar 会自动创建一个 Issue
    • preferred-color-scheme:您可以配置 Beaudar 以按编号加载特定的 Issue。 问题不会自动创建
    • 可以指定自己的名称: 将 Beaudar 配置为搜索标题包含您选择的特定名称的问题。如果未找到匹配问题，Beaudar 将自动创建第一次有人评论您的帖子时。Issue 的标题将是您选择的名称
  • theme: 主题
  • keep-theme: 将主题设置保存到页面的 sessionStorage，修改主题后刷新，主题设置不会丢失
  • label: 将分配给 Beaudar 创建的问题的标签,标签名称区分大小写。该标签必须存在于您的仓库中，无法附加不存在的标签。标签名称支持添加表情符号
  • loading: 点击加载图标可跳转至官方页面。
  • comment-order: 评论的发表时间排序
  • input-position: 评论框位置,当选择将评论顺序设置为“降序”时，建议将评论框放置在“顶部”。因为当评论数量很多时候，发表评论后可以第一时间看到评论发表成功
  • crossorigin: 跨域

常见问题

缺少 “beaudar.json” 配置

缺少 "beaudar.json" 配置
原因: 现在github的默认主分支是main, 不在是master. 所以分支找不到.
配置的时候指定分支为main就可以了.

hexo-fluid主题下的使用

将上述的 script脚本 在_config.yml中按如下方式添加即可

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 自定义底部 HTML 内容（位于 footer 上方），也可用于外部引入 js css 这些操作，注意不要和 post.custom 配置冲突
custom_html: '
<script src="https://beaudar.lipk.org/client.js"
        repo="Hanchers/hanchers.github.io"
        branch="main"
        issue-term="pathname"
        label="tag"
        theme="github-light"
        keep-theme="false"
        loading="false"
        comment-order="desc"
        input-position="top"
        crossorigin="anonymous"
        async>
</script>
'

但是效果比较丑，需要自己去调整一下css才与整个主题适配, 建议使用fluid主题已经集成好的组件。
fluid主题下的beaudar 评论插件效果

参考

beaudar Q&A

]]> + + + + + 网站 + + + + + + + 建站 + + beaudar + + 评论插件 + + + + + + + + + 如何写好java注释 + + /2022/09/01/java-java-doc-skill/ + + 什么是java注释

要回答这个问题,先提出一个说法:我们写的代码是给人看的,不是给机器看的.
如果你不认可这个说法,下面关于代码注释的一些总结想必对你也没啥帮助.
如果你认可这个说法, 那么下面的文章希望会给你一些帮助.

回到本段的主题,什么是java注释呢?

  1. 首先,注释是面向代码维护者的: 注释是对代码逻辑的一段说明, 方便后续的代码维护者能够快速的了解这段代码的含义,并依次为基础能够在现有代码的基础上做修改与维护.

  2. 其次,注释是面向系统使用者的: 要知道类似于java,或者spring这样偏向于底层,框架类的代码.全世界有数以万计的使用者的,这些人没精力也没有必要在调用api的时候去了解这段代码的底层实现逻辑,所以这段代码的api说明文档就显得很重要了.而代码上的注释就是相关api文档的主要来源.

  3. 通过javadoc命令,可以将注释抽离生成html文档,比如官方的java16API文档

如何写好java注释

想要写好代码的注释,我们要从注释的面向用户来考虑.不同的用户关注点还是有点差异的.

面向代码维护者

作为一名代码的维护者,当我们拿到一份没有任何注释的代码的时候,相信大家内心的感受是相同的.毕竟人类的悲欢并不相通, 除非看到没有注释的代码.

如果有了解设计模式的朋友,相信一定听说过一个设计原则:开闭原则, 对扩展开发,对修改关闭. 那么大家有没有想过为啥会有这个原则呢?

翻译一下: 修改现有的代码是有风险的,但是如果是扩展写新代码的话,作为开发者的你,是了解当前功能的前后背景的,而且你无论怎么写都不会对历史功能产生影响.所以对我们的代码设计能力提出来要求.

再翻译一下: 原来的代码既然跑的好好的,为啥要修改它呢, 改出问题来算谁的?

再翻译一下: 为啥我们不敢改以前的代码呢?谁知道当时为啥要写这段逻辑,谁知道这段逻辑有谁在用?改好了没有夸, 改崩了有锅背.

这就是我们维护老代码的困境!

作为一名程序员,我们要有一个概念,我们的代码是我们某个时刻的思维逻辑的固化.
如果是一个比较简单的逻辑,注释可以简单写写.
如果是一段比较复杂的逻辑,那么我们的注释要能够描述清楚我们当时的这段逻辑的背景(为什么要写这段逻辑), 意图(这段逻辑要实现什么效果), 用法(这段逻辑改如何使用,以及谁在用), 最好能有修改建议.

在业界开源的代码里有很多比较好的例子,来个spring的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/**
 * AOP Alliance MethodInterceptor for declarative transaction
 * management using the common Spring transaction infrastructure
 * ({@link org.springframework.transaction.PlatformTransactionManager}/
 * {@link org.springframework.transaction.ReactiveTransactionManager}).
 *
 * <p>Derives from the {@link TransactionAspectSupport} class which
 * contains the integration with Spring's underlying transaction API.
 * TransactionInterceptor simply calls the relevant superclass methods
 * such as {@link #invokeWithinTransaction} in the correct order.
 *
 * <p>TransactionInterceptors are thread-safe.
 *
 * @author Rod Johnson
 * @author Juergen Hoeller
 * @see TransactionProxyFactoryBean
 * @see org.springframework.aop.framework.ProxyFactoryBean
 * @see org.springframework.aop.framework.ProxyFactory
 */

面向api使用者

对于api的使用者,注释文档的要求相对简单些.

他们只关心这个方法的功能是什么, 以及入参有哪些,出参会有哪些, 会不会抛异常等, 会不会返回null等. 他们不关心这个方法的内部实现逻辑是啥, 比如一个排序方法, 使用者不关心这个方法内部使用冒泡排序,还是快排, 只要能完成诉求就行.

所以,面向api的使用者的注释,原则就是让他知道这个方法怎么使用就行了.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/**
* Returns an Image object that can then be painted on the screen. 
* The url argument must specify an absolute <a href="#{@link}">{@link URL}</a>. The name
* argument is a specifier that is relative to the url argument. 
* <p>
* This method always returns immediately, whether or not the 
* image exists. When this applet attempts to draw the image on
* the screen, the data will be loaded. The graphics primitives 
* that draw the image will incrementally paint on the screen. 
*
* @param  url  an absolute URL giving the base location of the image
* @param  name the location of the image, relative to the url argument
* @return      the image at the specified URL
* @see         Image
*/
public Image getImage(URL url, String name) {
try {
return getImage(new URL(url, name));
} catch (MalformedURLException e) {
return null;
}
}

写好java注释常用的技巧

常用的注释tag

  1. @param 方法参数
  2. @return 方法返回值
  3. @throws 方法抛出的异常, java1.2后添加
  4. @exception 同@throws
  5. @see 查看参考代码
  6. @author 标识作者
  7. @version 代码版本
  8. @since 从某个版本开始引入
  9. @serial( @serialField @serialData)
  10. @deprecated 废弃某个版本的代码

常用的内联tag

  1. {@code} : 代码高亮,等同于 {@literal}
1
<code>{@literal}</code>
  1. {@docRoot} : 标记文档的根路径,用来实现相对路径
1
2
3
/**
* See the <ahref="{@docRoot}/copyright.html">Copyright</a>.
*/
  1. {@inheritDoc} : 继承某个文档,嵌套文档使用
  2. {@link url} : 在注释文本区域内, 内联一个链接
1
2
Use the {@link #getComponentAt(int, int) getComponentAt} method.

  1. {@linkplain url label} 相对于{@link}, 支持自定义label文案来代指这段url
1
2
3
4
Refer to {@linkplain add() the overridden method}.
会显示为
Refer to 'the overridden method'.

  1. {@literal} 转义用, 方便显示一些特殊字符
  2. {@value} 常量时, 会直接显示标注代码的值

注释语句中的小技巧

@param @return @throws

一个正常方法必然会用到的注释tag,
@param 代表方法的入参,
@return 代表方法的返回值.
@throws 代表可能引发方法中断的异常. 等同与 @exception
这里需要特别说明一下, 有些人可能觉得只有那些受检异常(也就是必须在方法签名里声明的异常)才需要在注释里声明@throws. 其实不是的. 所有引发程序中断的异常, 包括运行时异常都可以在注释里说明, 也可以在方法签名里添加. 尤其是自定义的异常.
举个例子:

1
2
3
4
5
6
7
8
9
/**
 * Return the underlying ThreadPoolExecutor for native access.
 * @return the underlying ThreadPoolExecutor (never {@code null})
 * @throws IllegalStateException if the ThreadPoolTaskExecutor hasn't been initialized yet
 */
public ThreadPoolExecutor getThreadPoolExecutor() throws IllegalStateException {
Assert.state(this.threadPoolExecutor != null, "ThreadPoolTaskExecutor not initialized");
return this.threadPoolExecutor;
}

这里的IllegalStateException 是一个RuntimeException异常, 我们在方法里可能抛出这个异常, 最好是在方法签名里声明一下, 然后在代码注释里说明一下.

@see

当前代码可以参考的其他代码, 后面跟代码的全路径,可以是类,方法,属性等.具体参考如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@see #field
@see #Constructor(Type, Type...)
@see #Constructor(Type id, Type id...)
@see #method(Type, Type,...)
@see #method(Type id, Type, id...)
@see Class
@see Class#field
@see Class#Constructor(Type, Type...)
@see Class#Constructor(Type id, Type id)
@see Class#method(Type, Type,...)
@see Class#method(Type id, Type id,...)
@see package.Class
@see package.Class#field
@see package.Class#Constructor(Type, Type...)
@see package.Class#Constructor(Type id, Type id)
@see package.Class#method(Type, Type,...)
@see package.Class#method(Type id, Type, id)
@see package

@author

标识当前代码的作者是谁, 可以一个,也可以有多个.

@version @since

都是版本相关的tag
@version 标识当前版本好, 编译的时候会用到. 符合SCCS规范.
@since 标识这段代码的引入版本

@serial @serialField @serialData

序列化相关的属性, 标识哪些字段可以序列化,哪些不行.

@deprecated

废弃某段代码,表示不再维护,并在一段时间后会被删除. 标记后, 相关的引用位置会被标记为删除线.
个人认为这个tag还是很有用的:

  1. 创建代码容易删除难, 这个tag能够很好的帮忙我们去下线不再维护的代码,减轻维护压力.(愿世界上屎山越来越少)
  2. 方便我们代码升级. 如果我们要升级一段代码,先将老代码废弃,然后通过@see,引导用户使用新的方法.
1
2
3
4
5
6
/**
* @deprecated  As of JDK 1.1, replaced by 
*               
 setBounds
* @see #setBounds(int,int,int,int)
*/

html标签来排版

1
2
<p> : 新起一段
<br> : 换行

代码块样式

想在JAVA的注释中添加一段代码,并且可以优雅的编译出来还是挺麻烦的.下面提供一种方法

1
2
3
4
5
6
7
8
9
10
11
12
/**
  * 下面的代码注释可以按代码格式编译
  * <pre class=code>
  *     citys : [
  *         beijing,
  *         shanghai
  *      ]
  * </pre>
  *
  */
 private List<String>> citys;

参考

官方文档
javadoc - The Java API Documentation Generator
How and When To Deprecate APIs

]]> + + + + + 编程人生 + + + + + + + java + + + + + + + + + 算法套路 + + /2022/08/23/algorithm-skill/ + + 平时在刷算法题的时候经常会遇到一些套路, 也就是一些类似的小技巧. 这类技巧能够快速的帮我们解决某一类的算法问题. 这里就是整理一下自己遇到的,总结的算法技巧, 以及这些技巧可以应用与哪些场景.

1 滑动窗口(双指针)

个人理解,滑动窗口 的基础就是双指针. 即一个快指针代指窗口的头部, 一个慢指针代指窗口的尾部. 滑动窗口经过的地方就是我们要处理的数据.

滑动窗口示意图

如图所示,我们的滑动创建运动方向从左往右, 已经经过了区域1,正在经历区域2,3,4. 还没有经历区域5.

1.1 滑动窗口的特性

通过上面分析可知, 滑动窗口是一个窗口经过一段连续的区域,并实时计算统计经过区域内的一些值. 所以滑动窗口很适用的场景特点也就出来了:

  1. 单维度数据,比如字符串, 比如一维数组.
  2. 结果值有连续特性要求的. 因为滑动窗口必然是连续经过计算区域的.所遇到的值也必然是连续的.

1.2 常见场景

  1. 计算一个字符串内不含有重复字符的

未完待续

]]> + + + + + 算法 + + + + + + + 算法 + + + + + + + + + java中常用的工具类(2) System + + /2022/08/20/java-java-utils-2-system/ + + System工具类也是java中常用的一个工具类，并且从java 1.0 时代就存在了。它是不能被实例化的。我们这里介绍一下它的简单用法.

下面是官方介绍

The System class contains several useful class fields and methods. It cannot be instantiated.
Among the facilities provided by the System class are standard input, standard output, and error output streams; access to externally defined properties and environment variables; a means of loading files and libraries; and a utility method for quickly copying a portion of an array.

以下介绍System的常用方法

流相关

1
2
3
4
5
6
// 设置标准输入流
public static void setIn(InputStream in);
// 设置标准输出流
public static void setOut(PrintStream out);
// 设置标准错误输出流
public static void setErr(PrintStream err);

以上的流就会在System的标准流中使用

1
2
3
System.in.read();
System.out.println();
System.err.println();

获取一个基础虚拟机的流通道

1
2
3
4
5
6
// Returns the channel inherited from the entity that created this Java virtual machine.
// This method returns the channel obtained by invoking the inheritedChannel method of the system-wide default SelectorProvider object.
// In addition to the network-oriented channels described in inheritedChannel, this method may return other kinds of channels in the future.
public static Channel inheritedChannel() throws IOException

System.out.println(System.inheritedChannel());//null

安全相关

设置或获取 java虚拟机的安全管理器。这个我用的比较少，大家看注释吧。

1
2
3
4
5
6
7
8
9
// Sets the System security.
// If there is a security manager already installed, this method first calls the security manager's checkPermission method with a RuntimePermission("setSecurityManager") permission to ensure it's ok to replace the existing security manager. This may result in throwing a SecurityException.
public static void setSecurityManager(final SecurityManager s);

// if a security manager has already been established for the current application, then that security manager is returned; otherwise, null is returned.
public static SecurityManager getSecurityManager();

// 默认
System.out.println(System.getSecurityManager());// null

控制台

获取java的控制台对象，关于控制台命令交互可以通过这里获取

1
2
3
4
// Returns the unique Console object associated with the current Java virtual machine, if any.
// Returns: The system console, if any, otherwise null. 
// Since: 1.6
public static Console console()

时间相关

这应该是大家使用最频繁的几个接口。

  • 毫秒
1
2
3
4
// 获取当前系统时间戳（公元1970.1.1 凌晨到现在的毫秒数），native虚拟机实现
// the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC.
public static native long currentTimeMillis();

  • 纳秒精度数

获取当前系统的纳秒精度的数（基于当前虚拟机）。这个数是依据当前虚拟机的一个原点计算出来的一个高精度值，与具体的时间无关（比如毫秒方法获取的是1970到今天的时间戳，但纳秒的原点不是具体的某个时间点）
所以，这个方法的用处也就有了，就是基于同一个虚拟机的纳秒级精度的前后时间比较。
因为数据比较大，可以会有越界风险

1
2
3
// Returns the current value of the running Java Virtual Machine's high-resolution time source, in nanoseconds.
// This method can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time. The value returned represents nanoseconds since some fixed but arbitrary origin time (perhaps in the future, so values may be negative). The same origin is used by all invocations of this method in an instance of a Java virtual machine; other virtual machine instances are likely to use a different origin.
public static native long nanoTime();

数据拷贝

说实话，不太理解为什么这个方法会放在这里。可能在虚拟机底层里，数组copy是一个基础功能吧。
很常用。

1
2
// 将src数组srcPos位置开始的length元素复制到dest数组中，从dest数组中的destPos开始。
public static native void arraycopy(Object src,  int  srcPos,Object dest, int destPos, int length);

hash

返回对象的默认hashcode（即时被覆盖也不执行覆盖方法）
null 返回0

1
2
// Returns the same hash code for the given object as would be returned by the default method hashCode(), whether or not the given object's class overrides hashCode(). The hash code for the null reference is zero.
public static native int identityHashCode(Object x);

系统属性

  • 系统属性列表
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Key :  Description of Associated Value
// java.version :  Java Runtime Environment version
// java.vendor : Java Runtime Environment vendor
// java.vendor.url: Java vendor URL
// java.home:  Java installation directory
// java.vm.specification.version : Java Virtual Machine specification version
// java.vm.specification.vendor : Java Virtual Machine specification vendor
// java.vm.specification.name : Java Virtual Machine specification name
// java.vm.version : Java Virtual Machine implementation version
// java.vm.vendor : Java Virtual Machine implementation vendor
// java.vm.name : Java Virtual Machine implementation name
// java.specification.version : Java Runtime Environment specification version
// java.specification.vendor : Java Runtime Environment specification vendor
// java.specification.name : Java Runtime Environment specification name
// java.class.version : Java class format version number
// java.class.path : Java class path
// java.library.path : List of paths to search when loading libraries
// java.io.tmpdir : Default temp file path
// java.compiler : Name of JIT compiler to use
// java.ext.dirs : Path of extension directory or directories Deprecated. This property, and the mechanism which implements it, may be removed in a future release.
// os.name : Operating system name
// os.arch : Operating system architecture
// os.version : Operating system version
// file.separator : File separator ("/" on UNIX)
// path.separator : Path separator (":" on UNIX)
// line.separator : Line separator ("\n" on UNIX)
// user.name : User's account name
// user.home : User's home directory
// user.dir : User's current working directory
public static Properties getProperties()


  • 设置/替换系统属性
1
2
3
// 设置系统属性：props 换替换原来的系统属性，而非新增
public static void setProperties(Properties props)

  • 设置key属性
1
2
3
// 设置key的属性，并返回上一个value值
public static String setProperty(String key, String value)

  • 删除key属性
1
2
3
// 删除key ，并返回上个value值
public static String clearProperty(String key)

  • 查询key属性
1
2
3
4
5
//根据key 查属性值
public static String getProperty(String key)
// 根据key 查属性值，查不到返回默认值
public static String getProperty(String key, String def)

  • 系统换行符

linux/unix : \n
windows: \r\n

1
2
// On UNIX systems, it returns "\n"; on Microsoft Windows systems it returns "\r\n".
public static String lineSeparator()
  • 系统环境变量
1
2
3
4
5
6
// 全部环境变量 k：v
public static java.util.Map<String,String> getenv()

// 某个k的环境变量值
public static String getenv(String name)

系统相关

  • 退出

以某个状态终止虚拟机：非0 code 表示非正常结束

1
2
3
4
5
6
// Terminates the currently running Java Virtual Machine. The argument serves as a status code; by convention, a nonzero status code indicates abnormal termination.
// This method calls the exit method in class Runtime. This method never returns normally.
public static void exit(int status) {
    Runtime.getRuntime().exit(status);
}

  • 垃圾回收

执行垃圾回收

1
2
3
4
// Runs the garbage collector.
public static void gc() {
    Runtime.getRuntime().gc();
}
  • 执行Finalization
1
2
3
public static void runFinalization() {
    Runtime.getRuntime().runFinalization();
}
]]> + + + + + java + + 工具类 + + + + + + + java + + + + + + + + + java中常用的工具类(1) Objects + + /2022/08/19/java-java-utils-1-Objects/ + + 在java生态中有着众多的工具类，而有的工具类是我们常用而且如果用的好，会极大提高代码的优雅性与效率的，同时也能避免重复的造轮子。接下来我们一起了解一下这些工具类。

Objects

Objects是jdk官方自带的工具类，首先我们来看看Objects的官方简介：

This class consists of static utility methods for operating on objects. These utilities include null-safe or null-tolerant methods for computing the hash code of an object, returning a string for an object, and comparing two objects.Since: 1.7

这是一个私有的工具类，用来提供一些对Object的操作方法，包括null值的安全操作，一级hash值的计算等实用方法。jdk1.7 就提供了。

Objects的提供的静态方法如下：
Objects的工具方法

equals

用来比较两个对象的是否相等，null安全的，可以替换繁琐的判空校验。实现逻辑：

1
2
3
public static boolean equals(Object a, Object b) {
       return (a == b) || (a != null && a.equals(b));
}

deepEquals

数组的深度比较，同样null安全的。实现逻辑：

1
2
3
4
5
6
7
8
public static boolean deepEquals(Object a, Object b) {
        if (a == b)
            return true;
        else if (a == null || b == null)
            return false;
        else
            return Arrays.deepEquals0(a, b);
    }

hashCode

获取一个对象的hashCode，同样null安全的。实现逻辑：

1
2
3
public static int hashCode(Object o) {
        return o != null ? o.hashCode() : 0;
    }

​

hash

对一个数组求hash值，同样null安全的。实现逻辑：

1
2
3
public static int hash(Object... values) {
      return Arrays.hashCode(values);
  }

toString

调用对象o的toString方法，同样null安全的。不过这里要注意一下，如果是null的话，会返回null字符串。

相对应的，还有一个重载方法，toString(Object o, String nullDefault) 。 能够自定义null值的返回值，这个挺实用的。

实现逻辑：

1
2
3
4
5
6
7
8
9
10
11
12
  public static String toString(Object o) {
      return String.valueOf(o);
  }

# String.valueOf 实现
  public static String valueOf(Object obj) {
      return (obj == null) ? "null" : obj.toString();
  }

  public static String toString(Object o, String nullDefault) {
      return (o != null) ? o.toString() : nullDefault;
  }

compare

自定义实现大小比较逻辑，同样null安全的。实现逻辑：

1
2
3
public static <T> int compare(T a, T b, Comparator<? super T> c) {
        return (a == b) ? 0 :  c.compare(a, b);
    }

isNull

判断对象是null, 可以用来替换 obj==null 的写法，更优雅。 实现逻辑：

1
2
3
public static boolean isNull(Object obj) {
        return obj == null;
    }

​

nonNull

判断对象非null, 可以用来替换 obj!=null 的写法，更优雅。 实现逻辑：

1
2
3
public static boolean nonNull(Object obj) {
        return obj != null;
    }

​

requireNonNull

断言判断，要求一个对象是非空的。如果为空则抛出异常，有三个重载方法，可以自定义不同的异常message。

实现逻辑：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public static <T> T requireNonNull(T obj) {
       if (obj == null)
           throw new NullPointerException();
       return obj;
   }

   public static <T> T requireNonNull(T obj, String message) {
       if (obj == null)
           throw new NullPointerException(message);
       return obj;
   }

   public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier) {
       if (obj == null)
           throw new NullPointerException(messageSupplier.get());
       return obj;
   }

好了，jdk自动的Objects方法就介绍这些，有时间 我们再聊聊其他的常用工具类。

]]> + + + + + java + + 工具类 + + + + + + + java + + + + + + + + + hello world + + /2022/08/18/hello-world/ + + 梦开始的地方

]]> + + + + + 网站 + + + + + + + 建站 + + + + + + + + + diff --git a/page/2/index.html b/page/2/index.html new file mode 100644 index 00000000..6e515870 --- /dev/null +++ b/page/2/index.html @@ -0,0 +1,1050 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + + +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ + + + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/page/3/index.html b/page/3/index.html new file mode 100644 index 00000000..2ff52dd3 --- /dev/null +++ b/page/3/index.html @@ -0,0 +1,1069 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + + +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ + + + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/page/4/index.html b/page/4/index.html new file mode 100644 index 00000000..e2de7814 --- /dev/null +++ b/page/4/index.html @@ -0,0 +1,989 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + + +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ +
+ + + +
+ + + + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/readme.md b/readme.md new file mode 100644 index 00000000..914635af --- /dev/null +++ b/readme.md @@ -0,0 +1 @@ +[个人博客](https://www.hancher.top/), 欢迎光临! diff --git a/tags/apache/index.html b/tags/apache/index.html new file mode 100644 index 00000000..437d6f40 --- /dev/null +++ b/tags/apache/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - apache - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
URL存在http host头攻击漏洞的解决办法
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/bash/index.html b/tags/bash/index.html new file mode 100644 index 00000000..f426ed3f --- /dev/null +++ b/tags/bash/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - bash - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
如何给bash脚本进行加密？
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/beaudar/index.html b/tags/beaudar/index.html new file mode 100644 index 00000000..2e0647e1 --- /dev/null +++ b/tags/beaudar/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - beaudar - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
beaudar评论插件及常见问题解决
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/docker/index.html b/tags/docker/index.html new file mode 100644 index 00000000..ce9d1e84 --- /dev/null +++ b/tags/docker/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - docker - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
java应用连接docker内的oracle时报ORA-01882错误
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/dubbo/index.html b/tags/dubbo/index.html new file mode 100644 index 00000000..a9beb7f1 --- /dev/null +++ b/tags/dubbo/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - dubbo - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
dubbo 在线平滑变更zookeeper
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/elasticsearch/index.html b/tags/elasticsearch/index.html new file mode 100644 index 00000000..ad14104e --- /dev/null +++ b/tags/elasticsearch/index.html @@ -0,0 +1,428 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - elasticsearch - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2022

+ + + +
es在java工程中如何支持自定义的json格式的DSL
+ + + + + +
Elasticsearch重建索引
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/git/index.html b/tags/git/index.html new file mode 100644 index 00000000..3e3707bb --- /dev/null +++ b/tags/git/index.html @@ -0,0 +1,431 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - git - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2023

+ + + +
git优雅迁库的方式
+ + + + +

2022

+ + + +
macOS升级13 ventura后git无法使用的解决办法
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/hexo/index.html b/tags/hexo/index.html new file mode 100644 index 00000000..5377c9d9 --- /dev/null +++ b/tags/hexo/index.html @@ -0,0 +1,428 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - hexo - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2025

+ + + +
hexo建站增加自己的评论模块
+ + + + + +
jekyll迁移到Hexo博客架构全过程
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/index.html b/tags/index.html new file mode 100644 index 00000000..272937e4 --- /dev/null +++ b/tags/index.html @@ -0,0 +1,406 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/java/index.html b/tags/java/index.html new file mode 100644 index 00000000..005cdc2b --- /dev/null +++ b/tags/java/index.html @@ -0,0 +1,473 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - java - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/linux/index.html b/tags/linux/index.html new file mode 100644 index 00000000..9c361533 --- /dev/null +++ b/tags/linux/index.html @@ -0,0 +1,437 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - linux - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/mysql/index.html b/tags/mysql/index.html new file mode 100644 index 00000000..9d0dc743 --- /dev/null +++ b/tags/mysql/index.html @@ -0,0 +1,431 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - mysql - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2024

+ + + +
mysql出现了waiting for global read lock 全局事务等待问题排查
+ + + + +

2023

+ + + +
jdbc反序列化漏洞修复
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/nginx/index.html b/tags/nginx/index.html new file mode 100644 index 00000000..0755f7d1 --- /dev/null +++ b/tags/nginx/index.html @@ -0,0 +1,428 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - nginx - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2023

+ + + +
URL存在http host头攻击漏洞的解决办法
+ + + + + +
mac系统通过homebrew安装nginx
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/openapi/index.html b/tags/openapi/index.html new file mode 100644 index 00000000..83c6dec8 --- /dev/null +++ b/tags/openapi/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - openapi - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
springdoc-openapi的集成与常见问题
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/oracle/index.html b/tags/oracle/index.html new file mode 100644 index 00000000..9f45450a --- /dev/null +++ b/tags/oracle/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - oracle - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
java应用连接docker内的oracle时报ORA-01882错误
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/redis/index.html b/tags/redis/index.html new file mode 100644 index 00000000..80c93168 --- /dev/null +++ b/tags/redis/index.html @@ -0,0 +1,428 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - redis - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2022

+ + + +
redis常用命令总结
+ + + + + +
redis脚本命令
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/spring/index.html b/tags/spring/index.html new file mode 100644 index 00000000..2a463c45 --- /dev/null +++ b/tags/spring/index.html @@ -0,0 +1,458 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - spring - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/tags/vercel/index.html b/tags/vercel/index.html new file mode 100644 index 00000000..27ab7696 --- /dev/null +++ b/tags/vercel/index.html @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - vercel - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2024

+ + + +
如果让百度爬虫爬我的github博客
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\345\206\205\347\275\221\347\251\277\351\200\217/index.html" "b/tags/\345\206\205\347\275\221\347\251\277\351\200\217/index.html" new file mode 100644 index 00000000..275dce2a --- /dev/null +++ "b/tags/\345\206\205\347\275\221\347\251\277\351\200\217/index.html" @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 内网穿透 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2023

+ + + +
通过frp实现内网穿透功能
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\345\256\211\345\205\250/index.html" "b/tags/\345\256\211\345\205\250/index.html" new file mode 100644 index 00000000..3754c903 --- /dev/null +++ "b/tags/\345\256\211\345\205\250/index.html" @@ -0,0 +1,461 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 安全 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\345\273\272\347\253\231/index.html" "b/tags/\345\273\272\347\253\231/index.html" new file mode 100644 index 00000000..6212171f --- /dev/null +++ "b/tags/\345\273\272\347\253\231/index.html" @@ -0,0 +1,464 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 建站 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\345\274\202\345\270\270/index.html" "b/tags/\345\274\202\345\270\270/index.html" new file mode 100644 index 00000000..9d0d61ed --- /dev/null +++ "b/tags/\345\274\202\345\270\270/index.html" @@ -0,0 +1,443 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 异常 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\346\233\264\346\226\260\350\256\241\345\210\222/index.html" "b/tags/\346\233\264\346\226\260\350\256\241\345\210\222/index.html" new file mode 100644 index 00000000..a6dd904c --- /dev/null +++ "b/tags/\346\233\264\346\226\260\350\256\241\345\210\222/index.html" @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 更新计划 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2025

+ + + +
2025年博客更新计划
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\347\224\237\346\264\273/index.html" "b/tags/\347\224\237\346\264\273/index.html" new file mode 100644 index 00000000..472f08d8 --- /dev/null +++ "b/tags/\347\224\237\346\264\273/index.html" @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 生活 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2024

+ + + +
西部数据提供免费版Paragon实现与mac电脑的读写
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\347\256\227\346\263\225/index.html" "b/tags/\347\256\227\346\263\225/index.html" new file mode 100644 index 00000000..01654000 --- /dev/null +++ "b/tags/\347\256\227\346\263\225/index.html" @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 算法 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
算法套路
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\347\275\221\347\253\231\346\233\235\345\205\211/index.html" "b/tags/\347\275\221\347\253\231\346\233\235\345\205\211/index.html" new file mode 100644 index 00000000..ee5d6ec0 --- /dev/null +++ "b/tags/\347\275\221\347\253\231\346\233\235\345\205\211/index.html" @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 网站曝光 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2024

+ + + +
如果让百度爬虫爬我的github博客
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\350\257\204\350\256\272\346\217\222\344\273\266/index.html" "b/tags/\350\257\204\350\256\272\346\217\222\344\273\266/index.html" new file mode 100644 index 00000000..69eb9cc0 --- /dev/null +++ "b/tags/\350\257\204\350\256\272\346\217\222\344\273\266/index.html" @@ -0,0 +1,431 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 评论插件 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 2 篇文章

+
+ + + + +

2025

+ + + +
hexo建站增加自己的评论模块
+ + + + +

2022

+ + + +
beaudar评论插件及常见问题解决
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git "a/tags/\351\270\277\350\222\231/index.html" "b/tags/\351\270\277\350\222\231/index.html" new file mode 100644 index 00000000..2ac413cb --- /dev/null +++ "b/tags/\351\270\277\350\222\231/index.html" @@ -0,0 +1,422 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 标签 - 鸿蒙 - 寒澈笔记 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + +
+ +
+ +
+ +
+
+ +
+
+
+ + +
+

共计 1 篇文章

+
+ + + + +

2022

+ + + +
鸿蒙应用开发:"request data error"问题解决
+ + +
+ + + + + +
+
+
+
+
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/xml/local-search.xml b/xml/local-search.xml new file mode 100644 index 00000000..d7d0c01c --- /dev/null +++ b/xml/local-search.xml @@ -0,0 +1,45 @@ + + + {% if posts %} + {% for post in posts.toArray() %} + {% if post.indexing == undefined or post.indexing %} + + {{ post.title }} + + {{ [url, post.path] | urlJoin | uriencode }} + {% if content %} + + {% endif %} + {% if post.categories and post.categories.length>0 %} + + {% for cate in post.categories.toArray() %} + {{ cate.name }} + {% endfor %} + + {% endif %} + {% if post.tags and post.tags.length>0 %} + + {% for tag in post.tags.toArray() %} + {{ tag.name }} + {% endfor %} + + {% endif %} + + {% endif %} + {% endfor %} + {% endif %} + {% if pages %} + {% for page in pages.toArray() %} + {% if post.indexing == undefined or post.indexing %} + + {{ page.title }} + + {{ [url, post.path] | urlJoin | uriencode }} + {% if content %} + + {% endif %} + + {% endif %} + {% endfor %} + {% endif %} +