基于Streamlit开发，可在线查看S3存储内容的工具 （Python）

## S3 Browser 基于Streamlit开发，可在线查看S3存储内容的工具。 [DEMO](https://github.com/opendatalab/s3_browser/assets/1787294/18dbc19a-e998-407b-a5d0-031144e97069) ### 特性 * 文件夹/文件浏览 * 丰富的文件查看模式 * 针对JSONL格式优化，可按行预览前1MB的内容 * 存在图片的路径，支持预览查看图片 * 支持配置多个S3服务，灵活切换 * 支持通过浏览器下载文件 注：对象存储没有文件夹概念，仅为模拟文件系统方式进行查看。出于性能考虑，一个文件夹仅支持查看前1000个文件。 [](https://pypi.org/project/s3-browser-cli/) ### 使用 在HOME目录下编写配置文件`~/.streamlit/secrets.toml` 多套S3 AK/SK配置 ```toml [S3_Servers] [S3_Servers.S1] AK = "<Your S3 AK>" SK = "<Your S3 SK>" ENDPOINT_URL = "<Your S3 Endpoint Url>" [S3_Servers.S2] AK = "<Your S3 AK>" SK = "<Your S3 SK>" ENDPOINT_URL = "<Your S3 Endpoint Url>" ``` 单个S3也可以配置为 ``` [S3] AK = "<Your S3 AK>" SK = "<Your S3 SK>" ENDPOINT_URL = "<Your S3 Endpoint Url>" ``` 使用pip进行安装，启动服务 ```bash $ pip install s3-browser-cli $ s3_browser --help Usage: s3_browser [OPTIONS] Options: -p, --port INTEGER Specify alternate port [default: 8501] -a, --address TEXT specify alternate bind address (default: 127.0.0.1) --help Show this message and exit. $ s3_browser You can now view your Streamlit app in your browser. URL: http://127.0.0.1:8501 ``` 注：`secrets.toml` 配置文件也可以存放在命令s3_browser运行目录下`.streamlit/secrets.toml` Python版本依赖：`^3.10` 你也可以使用docker启动服务 ```bash $ docker run -p 8501:8501 -v $HOME/.streamlit/secrets.toml:/s3_browser/.streamlit/secrets.toml zhchbin/s3_browser:latest ``` 在浏览器中访问：`http://127.0.0.1:8501` ### 源码运行/开发 * 下载仓库 ```bash $ git clone https://github.com/opendatalab/s3_browser.git ``` * Python版本要求：`^3.10`，建议使用虚拟环境 * 编写配置文件 `.streamlit/secrets.toml` 方式一：Poetry * 安装poetry: https://python-poetry.org/ * 安装依赖并运行 ```bash $ poetry install $ poetry run streamlit run s3_browser/Welcome.py ``` 方式二：pip * 安装依赖 ```bash $ pip install -r requirements.txt ``` * 运行 ```bash $ streamlit run s3_browser/Welcome.py ```