Contains the Concourse pipeline definition for building a line-server container
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

169 lines
8.0 KiB

9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
  1. linx-server
  2. ======
  3. [![Build Status](https://travis-ci.org/andreimarcu/linx-server.svg?branch=master)](https://travis-ci.org/andreimarcu/linx-server)
  4. Self-hosted file/media sharing website.
  5. ### Features
  6. - Display common filetypes (image, video, audio, markdown, pdf)
  7. - Display syntax-highlighted code with in-place editing
  8. - Documented API with keys if need to restrict uploads (can use [linx-client](https://github.com/andreimarcu/linx-client) for uploading through command-line)
  9. - Torrent download of files using web seeding
  10. - File expiry, deletion key, and random filename options
  11. ### Screenshots
  12. <img width="200" src="https://user-images.githubusercontent.com/4650950/51735725-0033cf00-203d-11e9-8a97-f543330a92ec.png" /> <img width="200" src="https://user-images.githubusercontent.com/4650950/51735724-0033cf00-203d-11e9-8fe0-77442eaa8705.png" /> <img width="200" src="https://user-images.githubusercontent.com/4650950/51735726-0033cf00-203d-11e9-9fca-095a97e46ce8.png" /> <img width="200" src="https://user-images.githubusercontent.com/4650950/51735728-0033cf00-203d-11e9-90e9-4f2d36332fc4.png" />
  13. Get release and run
  14. -------------------
  15. 1. Grab the latest binary from the [releases](https://github.com/andreimarcu/linx-server/releases)
  16. 2. Run ```./linx-server```
  17. Usage
  18. -----
  19. #### Configuration
  20. All configuration options are accepted either as arguments or can be placed in an ini-style file as such:
  21. ```ini
  22. maxsize = 4294967296
  23. allowhotlink = true
  24. # etc
  25. ```
  26. ...and then invoke ```linx-server -config path/to/config.ini```
  27. #### Options
  28. - ```-bind 127.0.0.1:8080``` -- what to bind to (default is 127.0.0.1:8080)
  29. - ```-sitename myLinx``` -- the site name displayed on top (default is inferred from Host header)
  30. - ```-siteurl "https://mylinx.example.org/"``` -- the site url (default is inferred from execution context)
  31. - ```-selifpath "selif"``` -- path relative to site base url (the "selif" in mylinx.example.org/selif/image.jpg) where files are accessed directly (default: selif)
  32. - ```-maxsize 4294967296``` -- maximum upload file size in bytes (default 4GB)
  33. - ```-maxexpiry 86400``` -- maximum expiration time in seconds (default is 0, which is no expiry)
  34. - ```-allowhotlink``` -- Allow file hotlinking
  35. - ```-contentsecuritypolicy "..."``` -- Content-Security-Policy header for pages (default is "default-src 'self'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; frame-ancestors 'self';")
  36. - ```-filecontentsecuritypolicy "..."``` -- Content-Security-Policy header for files (default is "default-src 'none'; img-src 'self'; object-src 'self'; media-src 'self'; style-src 'self' 'unsafe-inline'; frame-ancestors 'self';")
  37. - ```-refererpolicy "..."``` -- Referrer-Policy header for pages (default is "same-origin")
  38. - ```-filereferrerpolicy "..."``` -- Referrer-Policy header for files (default is "same-origin")
  39. - ```-xframeoptions "..." ``` -- X-Frame-Options header (default is "SAMEORIGIN")
  40. - ```-remoteuploads``` -- (optionally) enable remote uploads (/upload?url=https://...)
  41. - ```-nologs``` -- (optionally) disable request logs in stdout
  42. #### Storage backends
  43. The following storage backends are available:
  44. |Name|Notes|Options
  45. |----|-----|-------
  46. |LocalFS|Enabled by default, this backend uses the filesystem|```-filespath files/``` -- Path to store uploads (default is files/)<br />```-metapath meta/``` -- Path to store information about uploads (default is meta/)|
  47. |S3|Use with any S3-compatible provider.<br> This implementation will stream files through the linx instance (every download will request and stream the file from the S3 bucket).<br><br>For high-traffic environments, one might consider using an external caching layer such as described [in this article](https://blog.sentry.io/2017/03/01/dodging-s3-downtime-with-nginx-and-haproxy.html).|```-s3-endpoint https://...``` -- S3 endpoint<br>```-s3-region us-east-1``` -- S3 region<br>```-s3-bucket mybucket``` -- S3 bucket to use for files and metadata<br>```-s3-force-path-style``` (optional) -- force path-style addresing (e.g. https://<span></span>s3.amazonaws.com/linx/example.txt)<br><br>Environment variables to provide:<br>```AWS_ACCESS_KEY_ID``` -- the S3 access key<br>```AWS_SECRET_ACCESS_KEY ``` -- the S3 secret key<br>```AWS_SESSION_TOKEN``` (optional) -- the S3 session token|
  48. #### SSL with built-in server
  49. - ```-certfile path/to/your.crt``` -- Path to the ssl certificate (required if you want to use the https server)
  50. - ```-keyfile path/to/your.key``` -- Path to the ssl key (required if you want to use the https server)
  51. #### Use with http proxy
  52. - ```-realip``` -- let linx-server know you (nginx, etc) are providing the X-Real-IP and/or X-Forwarded-For headers.
  53. #### Use with fastcgi
  54. - ```-fastcgi``` -- serve through fastcgi
  55. #### Require API Keys for uploads
  56. - ```-authfile path/to/authfile``` -- (optionally) require authorization for upload/delete by providing a newline-separated file of scrypted auth keys
  57. - ```-remoteauthfile path/to/remoteauthfile``` -- (optionally) require authorization for remote uploads by providing a newline-separated file of scrypted auth keys
  58. A helper utility ```linx-genkey``` is provided which hashes keys to the format required in the auth files.
  59. Cleaning up expired files
  60. -------------------------
  61. When files expire, access is disabled immediately, but the files and metadata
  62. will persist on disk until someone attempts to access them. If you'd like to
  63. automatically clean up files that have expired, you can use the included
  64. `linx-cleanup` utility. To run it automatically, use a cronjob or similar type
  65. of scheduled task.
  66. You should be careful to ensure that only one instance of `linx-client` runs at
  67. a time to avoid unexpected behavior. It does not implement any type of locking.
  68. #### Options
  69. - ```-filespath files/``` -- Path to stored uploads (default is files/)
  70. - ```-metapath meta/``` -- Path to stored information about uploads (default is meta/)
  71. - ```-nologs``` -- (optionally) disable deletion logs in stdout
  72. Deployment
  73. ----------
  74. Linx-server supports being deployed in a subdirectory (ie. example.com/mylinx/) as well as on its own (example.com/).
  75. #### 1. Using fastcgi
  76. A suggested deployment is running nginx in front of linx-server serving through fastcgi.
  77. This allows you to have nginx handle the TLS termination for example.
  78. An example configuration:
  79. ```
  80. server {
  81. ...
  82. server_name yourlinx.example.org;
  83. ...
  84. client_max_body_size 4096M;
  85. location / {
  86. fastcgi_pass 127.0.0.1:8080;
  87. include fastcgi_params;
  88. }
  89. }
  90. ```
  91. And run linx-server with the ```-fastcgi``` option.
  92. #### 2. Using the built-in https server
  93. Run linx-server with the ```-certfile path/to/cert.file``` and ```-keyfile path/to/key.file``` options.
  94. #### 3. Using the built-in http server
  95. Run linx-server normally.
  96. #### 4. Using Docker with the built-in http server
  97. First, build the image:
  98. ```docker build -t linx-server .```
  99. You'll need some directories for the persistent storage. For the purposes of this example, we will use `/media/meta` and `/media/files`.
  100. Then, run it:
  101. ```docker run -p 8080:8080 -v /media/meta:/data/meta -v /media/files:/data/files linx-server```
  102. Development
  103. -----------
  104. Any help is welcome, PRs will be reviewed and merged accordingly.
  105. The official IRC channel is #linx on irc.oftc.net
  106. 1. ```go get -u github.com/andreimarcu/linx-server ```
  107. 2. ```cd $GOPATH/src/github.com/andreimarcu/linx-server ```
  108. 3. ```go build && ./linx-server```
  109. License
  110. -------
  111. Copyright (C) 2015 Andrei Marcu
  112. This program is free software: you can redistribute it and/or modify
  113. it under the terms of the GNU General Public License as published by
  114. the Free Software Foundation, either version 3 of the License, or
  115. (at your option) any later version.
  116. This program is distributed in the hope that it will be useful,
  117. but WITHOUT ANY WARRANTY; without even the implied warranty of
  118. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  119. GNU General Public License for more details.
  120. You should have received a copy of the GNU General Public License
  121. along with this program. If not, see <http://www.gnu.org/licenses/>.
  122. Author
  123. -------
  124. Andrei Marcu, http://andreim.net/