Ubuntu使用docker安装gitea - 版本历史

2026年6月28日 (日) 02:18 Hovercool

2026-06-28T02:18:58Z

@@ 第164行： / 第164行： @@
        - "3000:3000"   # Web访问端口
        - "2222:22"     # SSH访问端口（映射到2222，避免与主机SSH冲突）
 </source>

2026年6月23日 (二) 05:54 Hovercool

2026-06-23T05:54:28Z

←上一版本		2026年6月23日 (二) 05:54的版本
第265行：		第265行：

	整个过程只需要等待镜像拉取和容器启动，数据和配置完整保留。		整个过程只需要等待镜像拉取和容器启动，数据和配置完整保留。

			== 八、更改域名 ==

			除了更dns和ngnix配置外，需修改gitea配置 /data/gitea/conf/app.ini并重启：
			<source lang="xml">

			[server]
			DOMAIN = git.your-new-domain.com
			SSH_DOMAIN = git.your-new-domain.com
			ROOT_URL = https://git.your-new-domain.com/

			</source>

2026年5月19日 (二) 18:35 Hovercool

2026-05-19T18:35:00Z

←上一版本		2026年5月19日 (二) 18:35的版本
第164行：		第164行：
	- "3000:3000" # Web访问端口		- "3000:3000" # Web访问端口
	- "2222:22" # SSH访问端口（映射到2222，避免与主机SSH冲突）		- "2222:22" # SSH访问端口（映射到2222，避免与主机SSH冲突）

	</source>		</source>

第227行：		第226行：

	用户在克隆仓库时会看到：ssh://git@服务器IP:2222/用户名/仓库名.git		用户在克隆仓库时会看到：ssh://git@服务器IP:2222/用户名/仓库名.git

			🎯注意：一旦通过 SSH_PORT 指定了一个非 22 的端口，Gitea 就无法再“借用”外部默认的 SSH 服务了，START_SSH_SERVER = true 就成了启动内置服务的“强制要求”。
			官方 Helm Charts 对此有一段权威的解释：
			''"For rootful Gitea images, the built-in OpenSSH server is reused, and Gitea itself does not listen on any SSH port. Therefore, the SSH_LISTEN_PORT setting has no effect. Explicitly setting START_SSH_SERVER helps avoid confusion and makes the behavior clearer."''
			''简单翻译：对于在 root 用户下运行的 Gitea 容器（最常见的情况），它会默认复用宿主机的 SSH 服务 (openssh-server)。此时，Gitea 程序本身不监听任何端口，SSH_LISTEN_PORT 设置也完全无效。所以，即使你不写 START_SSH_SERVER = true，它也不启动内置服务。''
			这就是为什么，通常在默认端口 22 下，即使不显式设置，SSH 也能“用”（实际上是复用宿主机的服务）。很多配置文章里提到“必须设置为 true”，其实恰恰就是因为它们都在修改默认的 SSH 端口。

	=== 方法二：使用宿主机SSH（高级，暂不推荐） ===		=== 方法二：使用宿主机SSH（高级，暂不推荐） ===

2026年5月19日 (二) 16:20 Hovercool

2026-05-19T16:20:09Z

←上一版本		2026年5月19日 (二) 16:20的版本
第179行：		第179行：
	# 启动服务（后台运行）		# 启动服务（后台运行）
	docker compose up -d		docker compose up -d

			# 重启gitea
			docker restart gitea
			docker-compose restart gitea #docker-compose部署

	# 查看运行状态		# 查看运行状态

2026年5月18日 (一) 16:02 Hovercool

2026-05-18T16:02:21Z

←上一版本		2026年5月18日 (一) 16:02的版本
第182行：		第182行：
	# 查看运行状态		# 查看运行状态
	docker compose ps		docker compose ps

			＃重新读取配置文件，并让 Docker 重启生效
			sudo systemctl daemon-reload
			sudo systemctl restart docker

	# 查看日志（如有问题）		# 查看日志（如有问题）

2026年5月18日 (一) 15:57 Hovercool

2026-05-18T15:57:58Z

←上一版本		2026年5月18日 (一) 15:57的版本
第230行：		第230行：
	</pre>		</pre>

	=== 七、未来迁移步骤（尚未验证） ===		== 七、未来迁移步骤（尚未验证） ==
	迁移时只需要打包整个 ~/gitea 目录，在新服务器上解压后执行 docker compose up -d 即可。		迁移时只需要打包整个 ~/gitea 目录，在新服务器上解压后执行 docker compose up -d 即可。
	当你需要更换服务器时：		当你需要更换服务器时：

2026年5月18日 (一) 15:57 Hovercool

2026-05-18T15:57:11Z

←上一版本		2026年5月18日 (一) 15:57的版本
第1行：		第1行：
	=~~一、安装docker~~=		=安装docker=
	==推荐使用官方apt仓库安装==		==推荐使用官方apt仓库安装==

第109行：		第109行：
	</source>		</source>

	=~~一、安装gitea~~=		=安装gitea=

	== 一、准备工作 ==		== 一、准备工作 ==

2026年5月18日 (一) 15:56 Hovercool

2026-05-18T15:56:19Z

←上一版本		2026年5月18日 (一) 15:56的版本
第230行：		第230行：
	</pre>		</pre>

			=== 七、未来迁移步骤（尚未验证） ===
	迁移时只需要打包整个 ~/gitea 目录，在新服务器上解压后执行 docker compose up -d 即可。		迁移时只需要打包整个 ~/gitea 目录，在新服务器上解压后执行 docker compose up -d 即可。
			当你需要更换服务器时：
			<source lang="bash">

			bash

			# 1. 在旧服务器上打包
			tar -czf gitea-backup.tar.gz ~/gitea/

			# 2. 传到新服务器
			scp gitea-backup.tar.gz 用户名@新服务器IP:~

			# 3. 在新服务器上（已安装Docker）
			tar -xzf gitea-backup.tar.gz
			cd ~/gitea
			docker compose up -d

			</source>

			整个过程只需要等待镜像拉取和容器启动，数据和配置完整保留。

2026年5月18日 (一) 15:53 Hovercool

2026-05-18T15:53:55Z

@@ 第84行： / 第84行： @@
 sudo usermod -aG docker $USER
 </source>
@@ 第228行： / 第231行： @@
 迁移时只需要打包整个 ~/gitea 目录，在新服务器上解压后执行 docker compose up -d 即可。

2026年5月18日 (一) 15:51 Hovercool

2026-05-18T15:51:48Z

←上一版本		2026年5月18日 (一) 15:51的版本
第110行：		第110行：
	== 一、准备工作 ==		== 一、准备工作 ==
	=== 1. 确保Docker和Docker Compose已安装 ===		=== 1. 确保Docker和Docker Compose已安装 ===
	bash		检查Docker是否已安装
			<source lang="bash">

	~~# 检查Docker是否已安装~~
	docker --version		docker --version
	docker compose version		docker compose version

			</source>

	如果未安装，可以参考之前的教程先安装Docker。		如果未安装，可以参考之前的教程先安装Docker。
	=== 2. 创建Gitea工作目录 ===		=== 2. 创建Gitea工作目录 ===
	bash		创建一个干净的目录，所有Gitea相关文件都会放在这里
			<source lang="bash">

	~~# 创建一个干净的目录，所有Gitea相关文件都会放在这里~~
	mkdir -p ~/gitea/{data,config}		mkdir -p ~/gitea/{data,config}
	cd ~/gitea		cd ~/gitea

			</source>

	这个 ~/gitea 目录就是未来迁移时需要整体打包的目录。		这个 ~/gitea 目录就是未来迁移时需要整体打包的目录。