处世如大梦，悟者能有几

作者：Pluto
更新时间：2026-04-15

演示环境为：ubuntu 22.04 LTS

安装ruby

sudo apt install -y ruby
# 安装gitlab-license库
sudo gem install gitlab-license

生成许可证

参考：https://www.rubydoc.info/gems/gitlab-license/

创建license.rb

require "openssl"
require "gitlab/license"

key_pair = OpenSSL::PKey::RSA.generate(2048)
File.open("license_key", "w") { |f| f.write(key_pair.to_pem) }

public_key = key_pair.public_key

File.open("license_key.pub", "w") { |f| f.write(public_key.to_pem) }

private_key = OpenSSL::PKey::RSA.new File.read("license_key")
Gitlab::License.encryption_key = private_key

license = Gitlab::License.new

license.licensee = {
  "Name" => "Aliait",
  "Company" => " Aliait'Inc ",
  "Email" => "aliait@aliait.org",
}
license.starts_at = Date.new(2025, 1, 1) # 开始时间
license.expires_at = Date.new(2099, 12, 31) # 结束时间
license.notify_admins_at = Date.new(2099, 12, 31)
license.notify_users_at = Date.new(2099, 12, 31)
license.block_changes_at = Date.new(2099, 12, 31)
license.restrictions = {
  active_user_count: 100000,
  previous_user_count: 11111,
  plan: "ultimate",
  id: 1,
  subscription_id: 1,
}

puts "License:"
puts license

data = license.export

puts "Exported license:"
puts data

File.open("GitLabBV.gitlab-license", "w") { |f| f.write(data) }

public_key = OpenSSL::PKey::RSA.new File.read("license_key.pub")
Gitlab::License.encryption_key = public_key

data = File.read("GitLabBV.gitlab-license")
$license = Gitlab::License.import(data)

puts "Imported license:"
puts $license

unless $license
  raise "The license is invalid."
end

if $license.restricted?(:active_user_count)
  active_user_count = 10000
  if active_user_count > $license.restrictions[:active_user_count]
    raise "The active user count exceeds the allowed amount!"
  end

end

if $license.notify_admins?
  puts "The license is due to expire on #{$license.expires_at}."
end

if $license.notify_users?
  puts "The license is due to expire on #{$license.expires_at}."
end

module Gitlab
  class GitAccess
    def check(cmd, changes = nil)
      if $license.block_changes?
        return build_status_object(false, "License expired")
      end
    end
  end

end

puts "This instance of GitLab Enterprise Edition is licensed to:"
$license.licensee.each do |key, value|
  puts "#{key}: #{value}"
end

if $license.expired?
  puts "The license expired on #{$license.expires_at}"
elsif $license.will_expire?
  puts "The license will expire on #{$license.expires_at}"
else
  puts "The license will never expire."
end

生成证书

sudo ruby license.rb

生成 GitLabBV.gitlab-license license_key license_key.pub 这三个文件。

使用许可证

替换默认公钥

sudo cp -f license_key.pub /opt/gitlab/embedded/service/gitlab-rails/.license_encryption_key.pub

修改等级

--- /opt/gitlab/embedded/service/gitlab-rails/ee/app/models/license.rb
+++ /opt/gitlab/embedded/service/gitlab-rails/ee/app/models/license.rb
@@ -277,7 +277,7 @@
  end
 
  def plan
-    restricted_attr(:plan).presence || STARTER_PLAN
+    restricted_attr(:plan).presence || ULTIMATE_PLAN
  end
 
  def edition

重新配置gitlab

sudo gitlab-ctl reconfigure

sudo gitlab-ctl restart

导入许可证

登录gitlab后台，管理中心->设置->通用->添加许可证 (/admin/application_settings/general)，选择“请输入许可证密钥”，输入GitLabBV.gitlab-license内容