无错源码

ShotShare 一个极简的个人图床程序

作者：

James

在

ShotShare banner image

一个非常简洁的图床程序，适合自己个人使用。

界面也是极简的。

An open-source self hosted image sharing platform.

About

ShotShare is an open source, self hosted, bare bones image posting/sharing platform, it was built to allow friends to upload screenshots and send links to their friends without the constant barrage of ads/extraneous features.

Demo

A demo may be found here. This environment is strictly for trialing the application; images added here are automatically after a few minutes.

Installation, Configuration, & Local Development

ShotShare is meant to be extremely easy to self host. Below is a sample deployment using Docker.

Example Deployment with Docker

  1. Create a directory for ShotShare: sudo mkdir /shotshare
  2. Create a .env file that will manage ShotShare generated environment variables (ex. your application key): sudo touch /shotshare/.env
  3. Ensure the user/group 82 (www-data user in docker container) own the .env file: sudo chown 82:82 /shotshare/.env
  4. Start the ShotShare container

You may wish to customize environment variables (such as the HOST) before running this command, see below for a list of environment variables.docker run \ -p 80:80 \ -p 443:443 \ -e HOST=localhost \ -v shotshare_caddy_data:/data \ -v shotshare_caddy_config:/config \ -v shotshare_database:/app/database \ -v shotshare_data:/app/storage \ –mount type=bind,source=/shotshare/.env,target=/app/.env \ -d \ –restart unless-stopped \ –name shotshare \ mdshack/shotshare:latest

Configuration Options

Note: These are not all of the configuration options, only the most used ones, feel free to open a PR if you see any missing. For a more in-depth look at all the available options check out here.

Environment VariableDefaultOptionsDescription
DB_CONNECTIONsqlitesqlite,mysql,pgsql,sqlsrvIndicates what database connection will be used
DB_HOST127.0.0.1N/ANot required if using sqlite, indicates the database host
DB_PORT3306N/ANot required if using sqlite, indicates the database port
DB_DATABASEshotshareN/ANot required if using sqlite, indicates the database database
DB_USERNAMEshotshareN/ANot required if using sqlite, indicates the database username
DB_PASSWORDnoneN/ANot required if using sqlite, indicates the database password
HOSTlocalhostN/APublic host used by Caddy, thanks to caddy, this host will automatically be issued a SSL certificate

Local Development

Local development is done using docker compose

  1. Pull the repo: git clone git@github.com:mdshack/shotshare.git
  2. Change to the ShotShare directory: cd shotshare
  3. Install dependencies: composer install; npm install
  4. Build frontend: npm run build
  5. Start docker compose: docker compose up

Contributing

There is currently no established pattern for contributing, if you see something missing or feel like something could be better feel free to pop open an issue and/or PR.

License

ShotShare is open-sourced and licensed under the MIT License.

评论

发表回复

更多文章