lsm/sa-token
1
0
Fork 0
mirror of https://gitee.com/dromara/sa-token.git synced 2026-02-27 16:50:24 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: 图片地址更换为本地文件 (附录篇)

Browse Source
This commit is contained in:
click33
2025-12-29 01:44:28 +08:00
parent f61d8369ac
commit ff3ce7daa5
8 changed files with 25 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
sa-token-doc/fun/auth-flow.md
View File

@@ -4,12 +4,12 @@
### Sa-Token 功能结构图：
![sa-token-rz](https://oss.dev33.cn/sa-token/art/sa-token-js4--2.png 's-w')
<img class="s-w" src="/big-file/doc/fun/sa-token-js4--2.png" alt="sa-token-rz" />
### Sa-Token 认证流程图：
![sa-token-rz](https://oss.dev33.cn/sa-token/art/sa-token-rz2.png 's-w')
<img class="s-w" src="/big-file/doc/fun/sa-token-rz2.png" alt="sa-token-rz" />
<!-- ![sa-token-rz](https://color-test.oss-cn-qingdao.aliyuncs.com/sa-token/sa-token-rz.png 's-w') -->
PS：鼠标右键选择 **`[在新窗口打开图片]`** 即可高清模式查看图片。(本流程图使用 [ProcessOn](https://www.processon.com) 绘制完成)
PS：鼠标右键选择 **`[在新窗口打开图片]`** 即可高清模式查看图片。

6
sa-token-doc/fun/curr-domain.md
View File

@@ -16,11 +16,11 @@ public String test() {
从浏览器访问此接口，我们可以看到：
![test-curr-domain.png](https://oss.dev33.cn/sa-token/doc/test-curr-domain.png 's-w-sh')
<img class="s-w-sh" src="/big-file/doc/fun/test-curr-domain.png" alt="test-curr-domain.png" />
此 API 在本地开发时一般可以正常工作，然而如果我们在部署时使用 Nginx 做了一层反向代理后，其最终结果可能会和我们预想的有一点偏差：
![test-curr-domain-fxdl.png](https://oss.dev33.cn/sa-token/doc/test-curr-domain-fxdl.png 's-w-sh')
<img class="s-w-sh" src="/big-file/doc/fun/test-curr-domain-fxdl.png" alt="test-curr-domain-fxdl.png" />
不仅是 Nginx，所有包含路由转发的地方都有可能导致上述丢失 uri 的现象，解决方案也很简单，既然程序无法自动识别，我们改成手动获取即可，Sa-Token 提供两个方案：
@@ -29,7 +29,7 @@ public String test() {
##### 1、首先在 Nginx 代理转发的地方增加参数
![nginx-add-header.png](https://oss.dev33.cn/sa-token/doc/nginx-add-header.png 's-w-sh')
<img class="s-w-sh" src="/big-file/doc/fun/nginx-add-header.png" alt="nginx-add-header.png" />
重点是这一句：`proxy_set_header Public-Network-URL http://$http_host$request_uri;`

24
sa-token-doc/fun/git-pr.md
View File

@@ -3,12 +3,12 @@
2. 滑动右侧页面滑块, 查看页面内容最下方, 评论区上方
3. 找到这一行文字
![在线编辑提示](https://oss.dev33.cn/sa-token/doc/git-pr/online_1.png)
<img src="/big-file/doc/fun/online_1.png" alt="在线编辑提示" />
4. 点击Gitee或GitHub按钮中的任意一个, 国内用户推荐使用 [Gitee](https://gitee.com) (请先注册登录后再往下浏览)
5. 此时会进入当前页面源码预览页面,找到下方按钮组
![按钮组](https://oss.dev33.cn/sa-token/doc/git-pr/online_2.png)
<img src="/big-file/doc/fun/online_2.png" alt="按钮组" />
6. 点击编辑按钮
7. 此时进入待修改页面的源码页面, 按照markdown格式编辑为需要的结果(Ctrl+P可查看最终效果,再次按下可恢复源码界面)
@@ -36,16 +36,16 @@ git config --list
1. 点击[Gitee](https://gitee.com/dromara/sa-token)或[Github](https://github.com/dromara/sa-token)进入Sa-Token项目主页, 以下以Gitee为例,Github类似(请先注册登录后再往下浏览)
2. 找到页面右上角的按钮组, 点击Forked按钮
![按钮组](https://oss.dev33.cn/sa-token/doc/git-pr/code_1.png)
<img src="/big-file/doc/fun/code_1.png" alt="按钮组" />
3. 选择个人仓库并点击确认
4. 此时在你的个人仓库中会多了一个Sa-Token项目
5. 在新的Sa-Token项目中, 点击 ![克隆/下载](https://oss.dev33.cn/sa-token/doc/git-pr/code_2.png) 按钮, 点击弹出框里面的复制按钮
5. 在新的Sa-Token项目中, 点击 <img src="/big-file/doc/fun/code_2.png" alt="克隆/下载" /> 按钮, 点击弹出框里面的复制按钮
6. 在本地某空文件夹下右键选择: git bash here
![git bash](https://oss.dev33.cn/sa-token/doc/git-pr/code_4.png)
<img src="/big-file/doc/fun/code_4.png" alt="git bash" />
![git bash 打开后的图](https://oss.dev33.cn/sa-token/doc/git-pr/code_3.png)
<img src="/big-file/doc/fun/code_3.png" alt="git bash 打开后的图" />
14. 在里面输入如下命令, 按换行后自动下载整个项目
@@ -61,18 +61,18 @@ git clone 这里替换为复制后的链接
### 方式一
1. 在idea中打开项目进入Commit选项
![本地暂存](https://oss.dev33.cn/sa-token/doc/git-pr/code_5.png)
<img src="/big-file/doc/fun/code_5.png" alt="本地暂存" />
2. 勾选需要本地暂存的文件
3. 在同一页面的下方输入提示信息
![提示信息](https://oss.dev33.cn/sa-token/doc/git-pr/code_6.png)
<img src="/big-file/doc/fun/code_6.png" alt="提示信息" />
4. 点击Commit按钮暂存到本地, 点击Commit and Push按钮暂存之后提交到远程
### 方式二
1. 除了点击Commit and Push按钮外,还有一个地方可以提交git
![git按钮](https://oss.dev33.cn/sa-token/doc/git-pr/code_7.png)
<img src="/big-file/doc/fun/code_7.png" alt="git按钮" />
2. 位置在idea右上方的工具栏里面
3. 指向左下箭头为拉取项目,可以随时更新
@@ -82,11 +82,11 @@ git clone 这里替换为复制后的链接
1. 提交后进入Gitee个人仓库中克隆的Sa-Token项目
2. 找到下图的Pull Request按钮
![工具栏](https://oss.dev33.cn/sa-token/doc/git-pr/code_8.png)
<img src="/big-file/doc/fun/code_8.png" alt="工具栏" />
3. 点击提交, 进入如下页面
![提交信息填写页面](https://oss.dev33.cn/sa-token/doc/git-pr/code_9.png 's-width')
<img class="s-width" src="/big-file/doc/fun/code_9.png" alt="提交信息填写页面" />
4. 在这里,你可以选择要提交的分支,一般都是dev开发分支.可以填写合并信息,其他测试审查之类的可以不填写, 最后点击创建即可完成一次提交.
@@ -94,7 +94,7 @@ git clone 这里替换为复制后的链接
1. 有时候主项目更新了,之前克隆的项目代码陈旧,如何处理?
2. 在个人仓库的Sa-Token项目主页面中, 找到下图的圆圈
![更新按钮](https://oss.dev33.cn/sa-token/doc/git-pr/code_10.png)
<img src="/big-file/doc/fun/code_10.png" alt="更新按钮" />
3. 点击右侧圆圈按钮后Gitee会自动同步主项目, 这样就不用像我之前一样,删除项目又重新fork了.

2
sa-token-doc/fun/sa-token-context--backup.md
View File

@@ -14,7 +14,7 @@
解决这个问题的关键就在于 `SaTokenContext` 接口，此接口的作用是屏蔽掉不同 Web 框架之间的差异，提供统一的调用API：
![sa-token-context](https://oss.dev33.cn/sa-token/doc/sa-token-context.svg 's-w')
<img class="s-w" src="/big-file/doc/fun/sa-token-context.svg" alt="sa-token-context" />
SaTokenContext只是一个接口，没有工作能力，这也就意味着 SaTokenContext 接口的实现是必须的。

2
sa-token-doc/fun/sa-token-context.md
View File

@@ -60,7 +60,7 @@ public static void setContext(HttpServletRequest request, HttpServletResponse re
Sa-Token 为了一套代码对接所有的 Web 框架，就在原生请求对象的基础上又封装了一层 `SaTokenContext` 相关接口，用于屏蔽掉不同 Web 框架之间的差异，提供统一的调用API：
![sa-token-context](https://oss.dev33.cn/sa-token/doc/plugin/sa-token-context-2.svg)
<img src="/big-file/doc/fun/sa-token-context-2.svg" alt="sa-token-context" />
因此，要对接不同的 Web 框架，就要针对不同的 Web 框架封装不同版本的 `SaRequest`、`SaResponse`、`SaStorage` 包装类对象。

2
sa-token-doc/fun/session-model.md
View File

@@ -99,7 +99,7 @@ session.updateTimeout(1000); // 参数说明和全局有效期保持一致
**假设三个客户端登录同一账号，且配置了不共享token，那么此时的Session模型是：**
![session-model](https://oss.dev33.cn/sa-token/doc/session-model3.png 's-w')
<img class="s-w" src="/big-file/doc/fun/session-model3.png" alt="session-model" />
简而言之：
- `Account-Session` 以账号 id 为主，只要 token 指向的账号 id 一致，那么对应的Session对象就一致

6
sa-token-doc/more/join-group.md
View File

@@ -6,8 +6,6 @@
### 1、加入QQ交流群
<!-- ![QQ群](https://oss.dev33.cn/sa-token/qr/qq-group-5-gsa.png ':size=180') -->
<!-- QQ交流群：685792424 [点击加入](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=Y05Ld4125W92YSwZ0gA8e3RhG9Q4Vsfx&authKey=IomXuIuhP9g8G7l%2ByfkrRsS7i%2Fna0lIBpkTXxx%2BQEaz0NNEyJq00kgeiC4dUyNLS&noverify=0&group_code=685792424)
-->
@@ -16,9 +14,9 @@ QQ交流群：823181187 [点击加入](https://qm.qq.com/q/EBIJVZBVGE)
### 2、加入微信交流群：
<!-- ![微信群](https://oss.dev33.cn/sa-token/wx-qr-300.png ':size=180') -->
<!-- <img class="s-w" src="/big-file/contact/wx-qr-300.png" style="width: 180px;" alt="微信群" /> -->
![微信群](https://oss.dev33.cn/sa-token/qr/i-wx-qr2.png ':size=175')
<img class="s-w" src="/big-file/contact/i-wx-qr2.jpg" style="width: 180px;" alt="微信群" />
（扫码添加微信，备注：sa，邀您加入群聊）

3
sa-token-doc/more/sa-token-donate.md
View File

@@ -10,7 +10,8 @@ Sa-Token 采用 Apache-2.0 开源协议，**承诺框架本身与官网文档永
您可以在项目 [Gitee](https://gitee.com/dromara/sa-token) 主页进行捐赠
![gitee-zanzhu2.png](https://oss.dev33.cn/sa-token/doc/gitee-zanzhu2.png)
<!-- ![gitee-zanzhu2.png](https://oss.dev33.cn/sa-token/doc/gitee-zanzhu2.png) -->
<img src="/big-file/doc/more/gitee-zanzhu2.png" alt="gitee-zanzhu2.png" />