# tiklab-gitpuk

**Repository Path**: taobinchen/tiklab-gitpuk

## Basic Information

- **Project Name**: tiklab-gitpuk
- **Description**: 一款开源的代码管理工具-服务端
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitpuk.tiklab.net
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-06-04
- **Last Updated**: 2025-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GitPuk代码管理工具
GitPuk是一款开源、免费的代码管理工具，提供了代码库、分支、权限管理、在线浏览代码、分支合并等能力。并可以通过操作记录便于追溯代码变更历史

# GitPuk功能介绍
   功能包括仓库组、代码库、分支、分支合并、代码扫描、git-lfs大文件存储等其他功能
### 仓库组管理
   更好地组织和管理多个相关的代码仓库。通过创建仓库组，团队可以更有效地对一系列相关联的项目进行分类。主要功能如下
-  统一管理关联的项目
-  单独的成员权限

   ![](https://image.tiklab.net/img/g1/homes/ab50a590e6977993)

   
### 仓库管理
简洁的仓库库管理界面，易用的属性，极大的提高了开发的效率。代码库功能大致如下
- 包含代码、提交信息、分支、标签、扫描等主要功能

  ![](https://image.tiklab.net/img/g1/homes/509e32d2ceb9ed4c)
- 支持http、ssh两种协议

 通过http、ssh协议推送拉取代码，使用ssh需要先添公钥

- 包含统计分析功能

 代码库内有提交次数统计、提交频率统计

-  内置成员权限

  每个项目拥有独立的成员与权限管理模块，并且支持自定义权限

### 分支管理
多分支管理结合分支的合并功能，在团队开发中极大的增加了协同能力；不同分支的代码文件对比，明确的看到代码的变动情况


### 合并请求管理
提高开发团队在多个分支之间高效协作。GitPuk 能够自动检测冲突，并为开发者提供直观的冲突解决方案，确保代码合并的准确性和一致性

支持四种合并方式：

| 合并方式    | 描述    |
| ------- | ------ |
| 创建一个合并节点   | 在合并后的分支创建一个合并的节点，记录合并信息  |
| Squash合并   | 被合并的分支的差异提交会压缩成一个合并的提交记录放在最后的合并的分支提交信息里面  |
| Rebase合并   | 被合并的差异提交重新定位到最后的合并的分支提交记录里面  |
| Fast-Forward-only合并   | 只能用于被合并的分支的提交超前需要合并的分支提交次数  |


### 代码扫描
代码扫描是一种自动化工具，旨在分析源代码以发现潜在的错误、安全漏洞和代码质量问题。
##### 扫描方式
- 集成SonarQube扫描
- 内嵌SpotBugs扫描
##### 代码扫描功能

| 功能    | 描述    |
| ------- | ------ |
| 静态代码分享  | 在不运行程序的情况下检查代码，发现语法错误、逻辑漏洞和不符合最佳实践的地方  |
| 安全漏洞检测   | 识别代码中的安全漏洞，如注入攻击、跨站脚本等，帮助提高应用程序的安全性  |
| 代码质量评估   | 提供代码复杂度、重复代码、未使用代码等报告，以便于优化和重构  |
| 遵循编码标准   | 确保代码符合行业标准和团队的编码规范，提升可读性和可维护性  |


### 其他功能
- 概览功能

概览分为系统级别概览、仓库级别的概览。系统概览展示最近访问的仓库以及所有仓库提交、成员的提交、以及待办信息；仓库级别概览展示该仓库的最近的提交、提交数量、该仓库的待办事项
- 代码提交记录

可以详细的记录仓库代码提交信息以及提交的代码，能够明确的知道每次提交代码相对于上次提交的修改、添加、删除
- 仓库标签

标签用于标记特定的版本或发布，帮助团队在更新和部署时保持一致。
- git-lfs大文件存储

通过使用 Git LFS，开发者能够更加高效地管理大文件，提升团队协作的流畅性与效率      
- 支持大文件清理

节省存储空间、提高系统性能、简化备份和恢复、维护数据整洁
- 代码统计功能

统计仓库代码的提交次数、代码提交频率

# GitPuk产品优势
   GitPuk优势分为安全可靠、系统集成、简洁易用、支持多版本多终端、开源免费，详情如下
### 安全可靠
   GitPuk在安全可靠通过下面多个角度体现出来
-   支持数据备份

   分为备份与恢复，支持定时备份、手动备份。防止数据误删，数据丢失
-   代码扫描

   识别代码中的安全隐患。提前发现和修复问题，减少后期维护的成本和时
-   权限控制

   包含系统权限控制、仓库权限控制，且支持自定义权限
-   日志审计

   实时记录操作变动，追溯到那个人，什么时间操作了什么
### 系统集成
   集成分为内部集成、外部集成
-   Tiklab内部每个应用集成

   体系完善灵活，可单独使用，也可配置统一登录，使用soular账号中心，灵活的搭配使用Tiklb中的其他应用
-   第三方应用集成

   集成导入gitee、gitlab、github、bitbucket第三方应用仓库


### 简洁易用
界面简洁，可直接使用，支持一键式部署安装。
- 界面简洁、操作方便

内置多个主题色，可灵活切换，界面干净、结构清晰
- 安装配置简单

线下版本支持一键安装启动，内嵌数据库、插件、运行环境，公有云部署版本注册即可使用
![](	https://community.tiklab.net/api/image/c980e7495d44277a)


### 支持多版本、多终端
- 支持线上公有云版本与线下私有部署版本

- 支持windows、linux、mac、docker


### 开源免费
GitPuk是免费开源，代码公开透明、灵活
- Gitee: https://gitee.com/tiklab-project/tiklab-gitpuk
- GitHub: https://github.com/tiklab-project/tiklab-gitpuk


# 安装

### 系统要求
* Java 16+
* Maven 3.4+
### 克隆仓库
```
git clone https://gitee.com/tiklab/tiklab-gitpuk.git
cd tiklab-gitpuk
```

### 配置MAVEN仓库
配置maven的settings.xml文件的远程仓库为一下内容
```
<mirror>
    <id>hadess</id>
    <name>hadess</name>
    <url>https://mirror.tiklab.net/repository/tiklab-maven</url>  
    <mirrorOf>*</mirrorOf>
</mirror> 
```

### 构建项目
* MAC系统：mvn clean package -P system-mac,env-dev
* Linux系统：mvn clean package -P system-linux,env-dev
* Windows系统：mvn clean package -P system-windows,env-dev

# 快速使用

1. 启动 GitPukApplication
2. 浏览器访问 http://localhost:8090
3. 登录信息，用户名：admin 密码：123456

# 贡献

我们欢迎社区的贡献！如果你有好的建议或发现了问题，请通过以下方式联系我：

联系我们

邮箱: tiklab@126.com

如需了解更多信息，请访问我们的官方网站或加入我们的社区讨论：

官网：https://tiklab.net

# 进阶使用

文档地址：https://doc.tiklab.net/document/78aa45b76d4c

演示地址：https://demo.tiklab.net/gitpuk