gitlab-ssl 8.1 KB
Newer Older
1 2 3 4
## GitLab
##
## Modified from nginx http version
## Modified from http://blog.phusion.nl/2012/04/21/tutorial-setting-up-gitlab-on-debian-6/
5
## Modified from https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html
6
##
7
## Lines starting with two hashes (##) are comments with information.
8
## Lines starting with one hash (#) are configuration parameters that can be uncommented.
9 10
##
##################################
11 12 13 14 15 16 17
##        CONTRIBUTING          ##
##################################
##
## If you change this file in a Merge Request, please also create
## a Merge Request on https://gitlab.com/gitlab-org/omnibus-gitlab/merge_requests
##
##################################
18 19 20 21 22 23 24 25 26 27
##        CHUNKED TRANSFER      ##
##################################
##
## It is a known issue that Git-over-HTTP requires chunked transfer encoding [0]
## which is not supported by Nginx < 1.3.9 [1]. As a result, pushing a large object
## with Git (i.e. a single large file) can lead to a 411 error. In theory you can get
## around this by tweaking this configuration file and either:
## - installing an old version of Nginx with the chunkin module [2] compiled in, or
## - using a newer version of Nginx.
##
28
## At the time of writing we do not know if either of these theoretical solutions works.
Ben Bodenmiller's avatar
Ben Bodenmiller committed
29
## As a workaround users can use Git over SSH to push large files.
30 31 32 33
##
## [0] https://git.kernel.org/cgit/git/git.git/tree/Documentation/technical/http-protocol.txt#n99
## [1] https://github.com/agentzh/chunkin-nginx-module#status
## [2] https://github.com/agentzh/chunkin-nginx-module
34 35
##
###################################
36
##         configuration         ##
37 38
###################################
##
39
## See installation.md#using-https for additional HTTPS configuration details.
40 41

upstream gitlab {
42
  server unix:/home/git/gitlab/tmp/sockets/gitlab.socket fail_timeout=0;
43 44
}

45 46 47
upstream gitlab-git-http-server {
  server unix:/home/git/gitlab/tmp/sockets/gitlab-git-http-server.socket fail_timeout=0;
}
48

49
## Redirects all HTTP traffic to the HTTPS host
50
server {
51 52 53 54
  ## Either remove "default_server" from the listen line below, 
  ## or delete the /etc/nginx/sites-enabled/default file. This will cause gitlab
  ## to be served if you visit any address that your server responds to, eg.
  ## the ip address of the server (http://x.x.x.x/)
55
  listen 0.0.0.0:80;
56
  listen [::]:80 ipv6only=on default_server;
57 58
  server_name YOUR_SERVER_FQDN; ## Replace this with something like gitlab.example.com
  server_tokens off; ## Don't show the nginx version number, a security best practice
59 60 61
  return 301 https://$server_name$request_uri;
  access_log  /var/log/nginx/gitlab_access.log;
  error_log   /var/log/nginx/gitlab_error.log;
62 63
}

64

Ben Bodenmiller's avatar
Ben Bodenmiller committed
65
## HTTPS host
66
server {
67
  listen 0.0.0.0:443 ssl;
68
  listen [::]:443 ipv6only=on ssl default_server;
69
  server_name YOUR_SERVER_FQDN; ## Replace this with something like gitlab.example.com
70
  server_tokens off; ## Don't show the nginx version number, a security best practice
71 72 73 74 75 76 77
  root /home/git/gitlab/public;

  ## Increase this if you want to upload large attachments
  ## Or if you want to accept large git objects over http
  client_max_body_size 20m;

  ## Strong SSL Security
78
  ## https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html & https://cipherli.st/
79 80 81 82
  ssl on;
  ssl_certificate /etc/nginx/ssl/gitlab.crt;
  ssl_certificate_key /etc/nginx/ssl/gitlab.key;

83
  # GitLab needs backwards compatible ciphers to retain compatibility with Java IDEs
84
  ssl_ciphers "ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:ECDHE-RSA-DES-CBC3-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4";
85 86 87
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
  ssl_prefer_server_ciphers on;
  ssl_session_cache shared:SSL:10m;
88
  ssl_session_timeout 5m;
89

90
  ## See app/controllers/application_controller.rb for headers set
91

92 93 94 95 96 97 98 99 100
  ## [Optional] If your certficate has OCSP, enable OCSP stapling to reduce the overhead and latency of running SSL.
  ## Replace with your ssl_trusted_certificate. For more info see:
  ## - https://medium.com/devops-programming/4445f4862461
  ## - https://www.ruby-forum.com/topic/4419319
  ## - https://www.digitalocean.com/community/tutorials/how-to-configure-ocsp-stapling-on-apache-and-nginx
  # ssl_stapling on;
  # ssl_stapling_verify on;
  # ssl_trusted_certificate /etc/nginx/ssl/stapling.trusted.crt;
  # resolver 208.67.222.222 208.67.222.220 valid=300s; # Can change to your DNS resolver if desired
101
  # resolver_timeout 5s;
102 103

  ## [Optional] Generate a stronger DHE parameter:
104
  ##   sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 4096
105 106 107
  ##
  # ssl_dhparam /etc/ssl/certs/dhparam.pem;

108 109 110 111 112 113 114 115 116 117
  ## Individual nginx logs for this GitLab vhost
  access_log  /var/log/nginx/gitlab_access.log;
  error_log   /var/log/nginx/gitlab_error.log;

  location / {
    ## Serve static files from defined root folder.
    ## @gitlab is a named location for the upstream fallback, see below.
    try_files $uri $uri/index.html $uri.html @gitlab;
  }

118 119
  ## We route uploads through GitLab to prevent XSS and enforce access control.
  location /uploads/ {
120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136
    ## If you use HTTPS make sure you disable gzip compression
    ## to be safe against BREACH attack.
    gzip off;

    ## https://github.com/gitlabhq/gitlabhq/issues/694
    ## Some requests take more than 30 seconds.
    proxy_read_timeout      300;
    proxy_connect_timeout   300;
    proxy_redirect          off;

    proxy_set_header    Host                $http_host;
    proxy_set_header    X-Real-IP           $remote_addr;
    proxy_set_header    X-Forwarded-Ssl     on;
    proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Proto   $scheme;
    proxy_set_header    X-Frame-Options     SAMEORIGIN;

137 138 139
    proxy_pass http://gitlab;
  }

140
  ## If a file, which is not found in the root folder is requested,
Ben Bodenmiller's avatar
Ben Bodenmiller committed
141
  ## then the proxy passes the request to the upsteam (gitlab unicorn).
142
  location @gitlab {
143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159
    ## If you use HTTPS make sure you disable gzip compression
    ## to be safe against BREACH attack.
    gzip off;

    ## https://github.com/gitlabhq/gitlabhq/issues/694
    ## Some requests take more than 30 seconds.
    proxy_read_timeout      300;
    proxy_connect_timeout   300;
    proxy_redirect          off;

    proxy_set_header    Host                $http_host;
    proxy_set_header    X-Real-IP           $remote_addr;
    proxy_set_header    X-Forwarded-Ssl     on;
    proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Proto   $scheme;
    proxy_set_header    X-Frame-Options     SAMEORIGIN;

160 161 162
    proxy_pass http://gitlab;
  }

163 164 165 166 167 168 169 170 171 172 173
  location ~ [-\/\w\.]+\.git\/ {
    ## If you use HTTPS make sure you disable gzip compression
    ## to be safe against BREACH attack.
    gzip off;

    ## https://github.com/gitlabhq/gitlabhq/issues/694
    ## Some requests take more than 30 seconds.
    proxy_read_timeout      300;
    proxy_connect_timeout   300;
    proxy_redirect          off;

174 175 176
    # Do not buffer Git HTTP responses
    proxy_buffering off;

177 178 179 180 181
    # The following settings only work with NGINX 1.7.11 or newer
    #
    # # Pass chunked request bodies to gitlab-git-http-server as-is
    # proxy_request_buffering off;
    # proxy_http_version 1.1;
182

183 184 185 186 187 188 189
    proxy_set_header    Host                $http_host;
    proxy_set_header    X-Real-IP           $remote_addr;
    proxy_set_header    X-Forwarded-Ssl     on;
    proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Proto   $scheme;
    proxy_pass http://gitlab-git-http-server;
  }
190

191 192
  ## Enable gzip compression as per rails guide:
  ## http://guides.rubyonrails.org/asset_pipeline.html#gzip-compression
Ben Bodenmiller's avatar
Ben Bodenmiller committed
193
  ## WARNING: If you are using relative urls remove the block below
194 195 196
  ## See config/application.rb under "Relative url support" for the list of
  ## other files that need to be changed for relative url support
  location ~ ^/(assets)/ {
197
    root /home/git/gitlab/public;
198 199 200 201 202 203 204
    gzip_static on; # to serve pre-gzipped version
    expires max;
    add_header Cache-Control public;
  }

  error_page 502 /502.html;
}