zwpanel/README.md
2024-01-11 10:05:09 +08:00

168 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align=center>
<img src="./doc/images/logo.png" width="100" height="100" />
# Sun-Panel
<a href="https://github.com/hslr-s/sun-panel.git">Github</a> | <a href="https://gitee.com/hslr/sun-panel.git">Gitee</a> | <a href="https://hub.docker.com/r/hslr/sun-panel">Docker Hub</a> | <a href="https://www.bilibili.com/video/BV1AC4y1U7va">bilibili</a> | <a href="https://www.youtube.com/channel/UCKwbFmKU25R602z6P2fgPYg">YouTube</a>
一个服务器、NAS导航面板、Homepage、浏览器首页。
</div>
![](./doc/images/icon-info-new.png)
## 😎 特点
- 简洁
- 局域网内外网链接切换
- docker部署,对arm系统支持
- 上手简单,免修改代码
- 无需连接外部数据库
- 丰富图标自由搭配(文字图标+svg图标+内置三方图标库)
- 支持网页内置小窗口打开(部分网站屏蔽此功能)
- 占用资源小
## 🧊 最新完整文档DOC
[最新完整文档DOC](https://sun-panel-doc.enianteam.com/)
## 🎨 演示demo
[查看演示站](https://sun-panel-doc.enianteam.com/introduce/demo_site.html)
## 🐳 联系作者&交流群
开发者:**[红烧猎人](https://blog.enianteam.com/u/sun/content/11)**
新建的QQ交流群进不去可以点上方连接联系作者
<img src="./doc/images/qq_group_qr.jpg" height="350" />
## 🍵 打赏
> 开源开发不易,如果觉得我的项目有帮到你,欢迎给我[打赏](./doc/donate.md)或者请我喝个奶茶☕(如果可以备注下您的昵称或者名字),你的支持就是我的动力,谢谢。
<a href="https://www.paypal.me/hslrs">
<img height="60" src="./doc/images/donate/paypal.png" target="_blank"></img>
</a>
| | |
| ------------ | ------------ |
| <img height="300" src="./doc/images/donate/weixin.png"/> | <img height="300" src="./doc/images/donate/alipay.png" /> |
## 🫓 TODO
- [x] 分组,拖拽排序
- [x] 导入导出功能
- [x] 增加访客账号
- [x] 帐号解除邮箱限制
- [x] 对上传的文件管理(针对账户增强重复利用,节省空间)
- [x] 服务器监控
- [x] 多国语言支持
- [ ] 用户自定义搜索框搜索引擎
- [ ] 搜索框样式自定义(背景颜色,文字颜色)
- [ ] docker管理器
- [ ] 计划任务
## 🖼️ 预览截图
**各种风格,自由搭配**
![](./doc/images/icon-small-new.png)
![](./doc/images/transparent-info.png)
![](./doc/images/transparent-small.png)
![](./doc/images/solid-color-info.png)
![](./doc/images/full-color-small.jpg)
**内置小窗口**
![](./doc/images/window-ssh.png)
![](./doc/images/window-xunlei.png)
## 🍜 使用运行教程
<div id="default-username"></div>
### 默认账号密码
账号admin@sun.cc
密码12345678
### 命令参数
|参数|说明|
|---|---|
|-h|查看命令说明|
|-config|生成配置文件conf/conf.ini|
|-password-reset|重置第一个用户的密码|
### 二进制文件运行
去 [Releases](https://github.com/hslr-s/sun-panel/releases) 下载二进制文件
执行示例
```sh
./sun-panel
```
#### 重置密码
执行示例
```sh
./sun-panel -password-reset
```
输出
```
密码已经重置成功,以下是账号信息
用户名 xxx@qq.com
密码 12345678
```
### docker 运行
目录挂载 `-v`,根据自己的需求选择:
|容器目录|说明|
|---|---|
|/app/conf|配置文件|
|/app/uploads|上传的文件|
|/app/database|数据库文件|
|/app/runtime|运行日志(不推荐挂载)|
1. 拉取镜像
```sh
docker pull hslr/sun-panel
```
2. 直接下载运行
```sh
docker run -d --restart=always -p 3002:3002 \
-v ~/docker_data/sun-panel/conf:/app/conf \
-v ~/docker_data/sun-panel/uploads:/app/uploads \
-v ~/docker_data/sun-panel/database:/app/database \
--name sun-panel \
hslr/sun-panel
```
### 自编译运行
[请参考完整文档](https://sun-panel-doc.enianteam.com/zh_cn/usage/compile.html)
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=hslr-s/sun-panel&type=Date)](https://star-history.com/#hslr-s/sun-panel&Date)
## ❤️ 感谢
- [Roc](https://github.com/RocCheng)
- [jackloves111](https://github.com/jackloves111)
- [Rock.L](https://github.com/gitlyp)
## LICENSE
[MIT](./LICENSE)