quickshare/docs/README_zh-cn.md

94 lines
3.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.

<h1 align="center">
Quickshare
</h1>
<p align="center">
简单的文件共享服务, 使用Go/Golang, Typescript, Gin, React, Boltdb等构建.
(<a href="https://github.com/ihexxa/quickshare/blob/main/docs/screenshots.md">界面截图</a>)
</p>
<p align="center">
<a href="https://github.com/ihexxa/quickshare/actions">
<img src="https://github.com/ihexxa/quickshare/workflows/quickshare-ci/badge.svg" />
</a>
<a href="https://goreportcard.com/report/github.com/ihexxa/quickshare">
<img src="https://goreportcard.com/badge/github.com/ihexxa/quickshare" />
</a>
<p>
<image src="./imgs/v0.9.1/quickshare_1920.gif" title="preview">
[English](../README.md) | 简体中文
> Quickshare 仍然活跃开发中, 请意识到目前每个版本并不保证向前兼容.
## 主要功能
- 文件管理
- 支持上传,下载,创建,删除和移动文件和文件夹
- 可恢复的上传和下载(断点续传)
- 在浏览器中管理文件和文件夹
- 多关键字的文件与目录查找,在几秒内返回结果
- 将目录共享他人,包括未登录用户
- 通过扫一扫访问共享文件夹/网站
- 一次上传上百个文件
- 流式上传: 使它可工作在 CDN 或 反向代理 之后
- 也可通过操作系统管理文件
- 用户管理
- 支持多用户
- 每个用户有个各自角色user/admin
- 用户 home 目录
- 用户级别的上传下载速度限制
- 用户级别的空间限制
- 其他
- 自适应 UI
- 多语言支持
- 自定义壁纸支持
- 跨平台: 支持 Linux, Mac and Windows
## 快速开始
### 通过 Docker 运行 (推荐)
下面会启动一个 `quickshare` docker 并监听 `8686` 端口.
然后你可以打开 `http://127.0.0.1:8686` 并且使用用户名 `qs` 和 密码 `1234` 登入.
```
docker run \
--name quickshare \
-d -p 8686:8686 \
-v `pwd`/quickshare/root:/quickshare/root \
-e DEFAULTADMIN=qs \
-e DEFAULTADMINPWD=1234 \
hexxa/quickshare
```
- `DEFAULTADMIN` 是默认的用户名
- `DEFAULTADMINPWD` 是默认的用户密码
- `/quickshare/root` 是 Quickshare 保存文件和目录的地方
- 如果你想同时在操作系统管理文件和文件夹,请参考 [这个文档](./docs/doc.md)
### 运行源代码
在开始之前, 请确认 Go/Golang (>=1.17), Node.js 和 Yarn 已经安装在您的机器.
```
# clone this repo
git clone git@github.com:ihexxa/quickshare.git
# go to repo's folder
cd quickshare
DEFAULTADMIN=qs DEFAULTADMINPWD=1234 yarn start
```
OK! 在浏览器中打开 `http://127.0.0.1:8686`, 并且使用用户名 `qs` 和 密码 `1234` 登入.
### 运行可执行文件
- **下载**: 下载最新的可执行文件 [Release Page](https://github.com/ihexxa/quickshare/releases).
- **解压**: 解压并执行 `DEFAULTADMIN=qs DEFAULTADMINPWD=1234 ./quickshare`. (你可能需要更新它的执行权限, 比如运行 `chmod u+x quickshare`)
- **访问**: 最后, 打开 `http://127.0.0.1:8686`, 并且使用用户名 `qs` 和 密码 `1234` 登入.
### 常见问题
Coming soon.