This commit is contained in:
swirl 2021-08-08 19:52:45 -04:00
parent 5ee34dfc2f
commit a970da095c
2 changed files with 204 additions and 90 deletions

View file

@ -36,7 +36,15 @@ A Minimal, SQLite-Backed URL Shortener
| $ curl -d https://duckduckgo.com {{.URL}}/ddg
| {{.URL}}/ddg
|
| 3. Deleting a short link
| 3. Create a short link to https://duckduckgo.com uaing a query string
| $ curl {{.URL}}?https://duckduckgo.com
| {{.URL}}/1acd382417199d7e
|
| 4. Create a short link with a custom path using a query string
| $ curl {{.URL}}/ddg?https://duckduckgo.com
| {{.URL}}/ddg
|
| 5. Deleting a short link
| $ TMP=$(mktemp)
| $ # temp file will store header
| $ LINK=$(curl -sS {{.URL}} -d https://duckduckgo.com -D $TMP)
@ -58,6 +66,7 @@ link here you will receive a 401 Unauthorized. If you like the examples above
and want to use this URL shortener you should self-host an instance. It's easy
to do (one of the design goals). Below are instructions detailing how.
<p>
{{end}}
<pre><code>| How to self-host:
|
@ -67,21 +76,93 @@ to do (one of the design goals). Below are instructions detailing how.
| b. Git version control
| <a href='https://git-scm.com/book/en/v2/Getting-Started-Installing-Git'>https://git-scm.com/book/en/v2/Getting-Started-Installing-Git</a>
|
| * On FreeBSD this would be:
| $ pkg install -y go git
| * Most distributions should have Go and Git in their repositories,
| simply as go and git.
| Install these through your package manager, e.g.:
| # pacman -S go git
| # emerge --ask dev-lang/go dev-vcs/git
| # apt install go git
|
| 2. Fetch, complile, and execute the source code
| $ env GO111MODULE=off go get git.fsh.ee/i/link
| $ env GO111MODULE=off go run git.fsh.ee/i/link -url https://your.domain.com -port 8080 -db /path/to/sqlite/file -seed secret
| 2. Fetch and compile the source code
| # env GO111MODULE=off go get git.swurl.xyz/swirl/link
|
| 3. Copy the binary to your binary directory
| # cp $GOPATH/bin/link /usr/local/bin/linkserv
| # # Named linkserv to prevent conflicts with GNU link
|
| 4. Create a directory to store your database:
| # mkdir -p /srv/link
|
| 5. (optional) Create a systemd service:
| # vim /etc/systemd/system/link.service
[Unit]
Description=link shortener
After=network.target
[Service]
ExecStart=/usr/local/bin/linkserv -url http://your.doma.in -db /srv/link/link.db -seed "secret"
[Install]
WantedBy=multi-user.target
|
| * You can also create an equivalent for openrc, runit, etc.
|
| 6. (optional) Enable and start
|
| 7. Or, run it manually:
| # linkserv -url http://your.doma.in -db /srv/link/link.db -seed "secret"
|
| * The server is now running on localhost at port 8080.
| * If the SQLite database at this filepath does not exist it will be created.
| * All logging will be printed to standard error and standard output.</code></pre>
{{end}}
| * If the SQLite database does not exist, it will be created.
| * All logging will be printed to standard error and standard output.
<footer style='white-space: pre;'>Source code: <a href='https://fsh.ee/src'>fsh.ee/src</a>
| Set up an NGINX reverse proxy:
|
| 1. Install dependencies
| * nginx
| * certbot
| * certbot nginx plugin
|
| * Most distributions should have these in their repositories:
| # pacman -S nginx certbot-nginx
| # emerge --ask www-servers/nginx app-crypt/certbot-nginx
| # apt install nginx python-certbot-nginx
|
| 2. Create the site file
| # vim /etc/nginx/sites-available/link
server {
rewrite_log on;
server_name your.doma.in;
location / {
proxy_pass http://localhost:8080; # or whatever port you're running link on
}
listen 80;
}
|
| 3. Enable the site
| # ln -s /etc/nginx/sites-{available,enabled}/link
|
| 4. Enable https for the site
| # certbot --nginx -d your.doma.in
|
| 4. Enable and start nginx
| # systemctl enable --now nginx
| # # Or, if you already have nginx running, reload it:
| # systemctl reload nginx
|
| * Your site should now be running on https://your.doma.in.
| * To run in a subdirectory, simply put the proxy_pass in the subdirectory, e.g.:
location /shortener {
proxy_pass http://localhost:8080;
}
| * If you want to use another HTTP server, then create the equivalent for that HTTP server.
</code></pre>
<footer style='white-space: pre;'>Source code: <a href='https://short.swurl.xyz/src'>short.swurl.xyz/src</a></a>
License: AGPL v3{{if .Copy}}
Copy: {{.Copy}}{{end}}
Made with: Go, Vim, and FreeBSD{{if .Demo}}
Unrelated blog: <a href='https://etc.fsh.ee/'>etc.fsh.ee</a>{{end}}
Made with: Go, Neovim, and Gentoo/Arch Linux
</footer>
</html>

39
main.go
View file

@ -170,7 +170,39 @@ func (c controller) ServeHTTP(rw http.ResponseWriter, r *http.Request) {
switch r.Method {
case http.MethodGet:
switch strings.TrimRight(r.URL.Path, "/") {
st := strings.TrimRight(r.URL.Path, "/")
rq := r.URL.RawQuery
if rq != "" {
u, err := url.Parse(rq)
if err != nil {
c.Err(rw, r, err)
return
}
if u.Scheme != "http" && u.Scheme != "https" {
rw.WriteHeader(http.StatusBadRequest)
fmt.Fprintf(rw, "URL must contain scheme, e.g. `http://` or `https://`.")
return
}
var (
link Link
h = strings.Trim(r.URL.Path, "/")
)
if h != "" {
link, err = c.db.NewLinkWithShortLink(u, h)
} else {
link, err = c.db.NewLink(u)
}
if err != nil {
c.Err(rw, r, err)
return
}
rw.Header().Set("X-Delete-With", link.Del)
rw.WriteHeader(http.StatusFound)
fmt.Fprintf(rw, "%s/%s", c.url, link.Smol)
return
} else {
switch st {
case "":
data := map[string]interface{}{
@ -198,6 +230,7 @@ func (c controller) ServeHTTP(rw http.ResponseWriter, r *http.Request) {
return
}
}
case http.MethodPost:
b, err := ioutil.ReadAll(r.Body)
@ -212,7 +245,7 @@ func (c controller) ServeHTTP(rw http.ResponseWriter, r *http.Request) {
}
if u.Scheme != "http" && u.Scheme != "https" {
rw.WriteHeader(http.StatusBadRequest)
fmt.Fprintf(rw, "URL must contain scheme. E.G. missing `http://` or `https://`.")
fmt.Fprintf(rw, "URL must contain scheme, e.g. `http://` or `https://`.")
return
}
var (
@ -270,7 +303,7 @@ func main() {
demo = flag.Bool("demo", false, "turn on demo mode")
port = flag.Uint("port", 8080, "port to listen on")
dbFilePath = flag.String("db", "", "sqlite database filepath: required")
url = flag.String("url", "", "service url: required")
url = flag.String("url", "", "URL which the server will be running on: required")
hashSeed = flag.String("seed", "", "hash seed: required")
copy = flag.String("copy", "", "copyright information")
)